add_project_contributor

Endpoint#

Property	Value
Type	mutation
Method	POST
Path	/api/external/v1/add_project_contributor
Handler	OperatelyWeb.Api.Mutations.AddProjectContributor

Authentication#

• Requires a valid API token.
• Requires a write-enabled token.
• Read-only tokens return 403.

Inputs#

Field	Type	Required	Nullable	Default
project_id	id primitive (encoded as string)	Yes	No	-
person_id	id primitive (encoded as string)	Yes	No	-
responsibility	string	Yes	No	-
permissions	access_options enum (no_access, minimal_access, view_access, comment_access, edit_access, admin_access, full_access)	Yes	No	-
role	string	Yes	Yes	-

Outputs#

Field	Type	Required	Nullable
project_contributor	project_contributor object	No	Yes

cURL Example#

Copied

curl --request POST \
  --url "https://app.operately.com/api/external/v1/add_project_contributor" \
  --header "Authorization: Bearer ${OPERATELY_API_TOKEN}" \
  --header "Content-Type: application/json" \
  --data '{"permissions":"no_access", "person_id":"value", "project_id":"value", "responsibility":"value", "role":"value"}'

Response Example#

{
  "project_contributor": {
    "access_level": 123,
    "id": "value",
    "permissions": "<project_permissions>",
    "person": "<person>",
    "project": "<project>",
    "responsibility": "value",
    "role": "value"
  }
}