v68

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,21696712.3 MB
copilot-spaces

Create a resource for a Copilot Space for a user

Creates a new resource in a specific Copilot Space owned by a user. The authenticated user must have write permissions on the space.

The following resource types are supported: repository, github_file, free_text, github_issue, github_pull_request. The uploaded_text_file and media_content types are not supported via this endpoint.

For github_file resources, if a resource with the same repository, file path, and SHA already exists, the existing resource is returned with a 200 status.

OAuth app tokens and personal access tokens (classic) need the write:user scope to use this endpoint.

post/users/{username}/copilot-spaces/{space_number}/resources

Path parameters

usernamestring required

The handle for the GitHub user account.

space_numberinteger required

The unique identifier of the Copilot Space.

Request body

resource_type'repository' | 'github_file' | 'free_text' | 'github_issue' | 'github_pull_request' required

The type of resource to create.

metadataobject required

Resource-specific metadata.

Response

Duplicate github_file resource already exists

idinteger required

The unique identifier of the resource.

resource_type'repository' | 'github_file' | 'free_text' | 'github_issue' | 'github_pull_request' | 'media_content' | 'uploaded_text_file' required

The type of the resource.

copilot_chat_attachment_idinteger nullable

The ID of the associated chat attachment, if any.

metadataobject required

Resource-specific metadata. The keys and values depend on the resource type.

created_atstring date-time required

The date and time the resource was created.

updated_atstring date-time required

The date and time the resource was last updated.