Add or Update a collaborator to a repository

PUT

/repos/{owner}/{repo}/collaborators/{collaborator}

const url = 'https://gitea.example.com/api/v1/repos/example/example/collaborators/example';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <credentials>', 'Content-Type': 'application/json'},
  body: '{"permission":"read"}'
};

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://gitea.example.com/api/v1/repos/example/example/collaborators/example \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "permission": "read" }'

Authorizations

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

collaborator

required

string

Username of the user to add or update as a collaborator

Request Body

application/json

AddCollaboratorOption options when adding a user as a collaborator of a repository

object

permission

string

Allowed values: read write admin

Responses

204

APIEmpty is an empty response

application/json

403

APIForbiddenError is a forbidden error response

application/json

Headers

message

string

url

string

404

APINotFound is a not found empty response

application/json

422

APIValidationError is error format response related to input validation

application/json

Headers

message

string

url

string