Skip to content

Records a publication target in a workspace: an approved credential binding, an approved repository binding, the branch prefix pushes must stay under and the allowed merge bases.

POST
/v1/m/gitpublish/targets
curl --request POST \
--url https://example.com/v1/m/gitpublish/targets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "credential_binding_id": "example", "merge_bases": [ "example" ], "push_prefix": "example", "repository_binding_id": "example", "workspace_id": "example" }'

Records a publication target in a workspace: an approved credential binding, an approved repository binding, the branch prefix pushes must stay under and the allowed merge bases.

X-Olivares-Tenant
string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

The handler decodes one strict JSON document, bounded at 1 MiB; an unknown field is field_not_accepted.

Media type application/json
object
credential_binding_id
required

An approved credential binding in the caller’s permitted scope; never a secret reference.

string
merge_bases
Array<string>
<= 16 items
push_prefix
required

Branch prefix ending in ‘/’; pushes and pull-request heads must be under it.

string
/^[A-Za-z0-9._/-]+$/
repository_binding_id
required

An approved server repository binding; never a path.

string
workspace_id
required

The workspace the target belongs to.

string
Example generated
{
"credential_binding_id": "example",
"merge_bases": [
"example"
],
"push_prefix": "example",
"repository_binding_id": "example",
"workspace_id": "example"
}

OK

Media type application/json
object
Example generated
{}

Bad request

Media type application/json
object
Example generated
{}

Unauthenticated

Media type application/json
object
Example generated
{}

Forbidden

Media type application/json
object
Example generated
{}

Not found

Media type application/json
object
Example generated
{}

Conflict / setup required

Media type application/json
object
Example generated
{}

Rate limited

Media type application/json
object
Example generated
{}