Replaces a publication target's bindings, push prefix and merge bases under optimistic concurrency, refusing a stale expected_version.
PUT
/v1/m/gitpublish/targets/{id}
const url = 'https://example.com/v1/m/gitpublish/targets/example';const options = { method: 'PUT', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"credential_binding_id":"example","expected_version":1,"merge_bases":["example"],"push_prefix":"example","repository_binding_id":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://example.com/v1/m/gitpublish/targets/example \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "credential_binding_id": "example", "expected_version": 1, "merge_bases": [ "example" ], "push_prefix": "example", "repository_binding_id": "example" }'Replaces a publication target’s bindings, push prefix and merge bases under optimistic concurrency, refusing a stale expected_version.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ” id
required
string
Path parameter id.
Header Parameters
Section titled “ Header Parameters ” X-Olivares-Tenant
string format: uuid
Target tenant id; required when the principal can act in more than one tenant.
Request Body required
Section titled “ Request Body required ”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
An approved credential binding in the caller’s permitted scope; never a secret reference.
string
expected_version
required
Optimistic concurrency: the version read.
integer
merge_bases
Array<string>
push_prefix
required
Branch prefix ending in ‘/’; pushes and pull-request heads must be under it.
string
repository_binding_id
An approved server repository binding; never a path.
string
Example generated
{ "credential_binding_id": "example", "expected_version": 1, "merge_bases": [ "example" ], "push_prefix": "example", "repository_binding_id": "example"}Responses
Section titled “ Responses ”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
{}