curl -X PUT 'https://api.github.com/users/example-username/copilot-spaces/10/collaborators/User/example-actor-identifier' \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H 'Accept: application/vnd.github+json' \
  -H 'X-GitHub-Api-Version: 2026-03-10' \
  -H 'Content-Type: application/json' \
  -d '{
  "role": "reader"
}'

# PUT /users/{username}/copilot-spaces/{space_number}/collaborators/{actor_type}/{actor_identifier} (GitHub API)
Base URL: https://api.github.com
Auth: Authorization; GitHub token; required.
Request formats: application/json.
Last verified: 2026-10-20

> Set a collaborator role for a Copilot Space for a user

## Critical Gotchas
* GitHub recommends an `Accept: application/vnd.github+json` header and an explicit `X-GitHub-Api-Version` header.
* Fine-grained tokens only authorize repositories and permissions selected when the token is created.

## cURL
curl -X PUT 'https://api.github.com/users/example-username/copilot-spaces/10/collaborators/User/example-actor-identifier' \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H 'Accept: application/vnd.github+json' \
  -H 'X-GitHub-Api-Version: 2026-03-10' \
  -H 'Content-Type: application/json' \
  -d '{
  "role": "reader"
}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| username | path | string | Yes | The handle for the GitHub user account. |
| space_number | path | integer | Yes | The unique identifier of the Copilot Space. |
| actor_type | path | string | Yes | The type of actor (must be `User` for user-owned spaces; `Team` will be rejec... |
| actor_identifier | path | string | Yes | The username of the collaborator. The numeric user ID is also accepted. |
| role | body | string | Yes | The new role to grant to the collaborator. Use `no_access` to remove the coll... |

## Response example
{"name":"string","email":"string"}

---
Need an API key? Get one at https://github.com/settings/tokens

PUT

PUT /users/{username}/copilot-spaces/{space_number}/collaborators/{actor_type}/{actor_identifier} — GitHub API

GitHub token (required); https://api.github.com

GitHub API

Set a collaborator role for a Copilot Space for a user

Base URL: https://api.github.com
Auth: Authorization: Bearer <GITHUB_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 299 tokens · Vary: Accept

Critical gotchas

GitHub recommends an Accept: application/vnd.github+json header and an explicit X-GitHub-Api-Version header.

Fine-grained tokens only authorize repositories and permissions selected when the token is created.

cURL

curl -X PUT 'https://api.github.com/users/example-username/copilot-spaces/10/collaborators/User/example-actor-identifier' \  -H "Authorization: Bearer $GITHUB_TOKEN" \  -H 'Accept: application/vnd.github+json' \  -H 'X-GitHub-Api-Version: 2026-03-10' \  -H 'Content-Type: application/json' \  -d '{  "role": "reader"}'

Parameters

Name	In	Type	Required	Description
username	path	string	Yes	The handle for the GitHub user account.
space_number	path	integer	Yes	The unique identifier of the Copilot Space.
actor_type	path	string	Yes	The type of actor (must be `User` for user-owned spaces; `Team` will be rejected).
actor_identifier	path	string	Yes	The username of the collaborator. The numeric user ID is also accepted.
role	body	string	Yes	The new role to grant to the collaborator. Use `no_access` to remove the collaborator.

Response 200 OK

{
  "name": "string",
  "email": "string",
  "login": "octocat",
  "id": 1,
  "node_id": "MDQ6VXNlcjE=",
  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
  "gravatar_id": "41d064eb2195891e12d0413f63227ea7",
  "url": "https://api.github.com/users/octocat",
  "html_url": "https://github.com/octocat",
  "followers_url": "https://api.github.com/users/octocat/followers",
  "following_url": "https://api.github.com/users/octocat/following{/other_user}",
  "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
  "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
  "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
  "organizations_url": "https://api.github.com/users/octocat/orgs",
  "repos_url": "https://api.github.com/users/octocat/repos",
  "events_url": "https://api.github.com/users/octocat/events{/privacy}",
  "received_events_url": "https://api.github.com/users/octocat/received_events",
  "type": "User",
  "site_admin": true,
  "starred_at": "\"2020-07-09T00:17:55Z\"",
  "user_view_type": "public",
  "actor_type": "User",
  "role": "reader"
}

Get a free GitHub API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.