repositories

Creates, updates, deletes, gets or lists a repositories resource.

Overview

Name	repositories
Type	Resource
Id	vercel.vcr.repositories

Fields

The following fields are returned by SELECT queries:

get

A Vercel Container Registry repository.

Name	Datatype	Description
id	string	Unique identifier of the repository. (example: repo_a1b2c3d4e5f6)
name	string	Name of the repository. (example: my-app)
project_id	string	Identifier of the project the repository belongs to. (example: prj_a1b2c3d4e5f6) (wire: projectId)
created_at	string	ISO 8601 timestamp of when the repository was created. (example: 2026-06-30T10:00:00.000Z) (wire: createdAt)
public	boolean	Whether the repository is public. Images in public repositories can be pulled by anyone. Defaults to false (private). (false, true)
updated_at	string	ISO 8601 timestamp of when the repository was last updated. (example: 2026-06-30T10:00:00.000Z) (wire: updatedAt)

list

A Vercel Container Registry repository.

Name	Datatype	Description
id	string	Unique identifier of the repository. (example: repo_a1b2c3d4e5f6)
name	string	Name of the repository. (example: my-app)
project_id	string	Identifier of the project the repository belongs to. (example: prj_a1b2c3d4e5f6) (wire: projectId)
created_at	string	ISO 8601 timestamp of when the repository was created. (example: 2026-06-30T10:00:00.000Z) (wire: createdAt)
public	boolean	Whether the repository is public. Images in public repositories can be pulled by anyone. Defaults to false (private). (false, true)
updated_at	string	ISO 8601 timestamp of when the repository was last updated. (example: 2026-06-30T10:00:00.000Z) (wire: updatedAt)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	project_id, id_or_name	team_id, slug	Fetch a container registry repository for a project by ID or name.
list	select	project_id	limit, cursor, team_id, slug	List container registry repositories for a project.
create	insert	project_id, name	team_id, slug	Create a container registry repository for a project.
delete	delete	project_id, id_or_name	team_id, slug	Schedule a repository for deletion. The repository is marked so it disappears from list/get immediately; subscriber-vcr reclaims every image (manifests, blobs, tags and rows) and finally deletes the repository row asynchronously via the VcrRepositoryRemoved event.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
id_or_name	string
project_id	string	Project ID. Missing or empty values return HTTP 400. (wire: projectId)
cursor	string	Opaque pagination cursor returned by a previous list response.
limit	integer
slug	string	The Team slug to perform the request on behalf of.
team_id	string	The Team identifier to perform the request on behalf of. (wire: teamId)

SELECT examples

get

Fetch a container registry repository for a project by ID or name.

SELECT
id,
name,
project_id,
created_at,
public,
updated_at
FROM vercel.vcr.repositories
WHERE project_id = '{{ project_id }}' -- required
AND id_or_name = '{{ id_or_name }}' -- required
AND team_id = '{{ team_id }}'
AND slug = '{{ slug }}'
;

list

List container registry repositories for a project.

SELECT
id,
name,
project_id,
created_at,
public,
updated_at
FROM vercel.vcr.repositories
WHERE project_id = '{{ project_id }}' -- required
AND limit = '{{ limit }}'
AND cursor = '{{ cursor }}'
AND team_id = '{{ team_id }}'
AND slug = '{{ slug }}'
;

INSERT examples

create

Create a container registry repository for a project.

INSERT INTO vercel.vcr.repositories (
project_id,
name,
team_id,
slug
)
SELECT 
'{{ project_id }}' /* required */,
'{{ name }}' /* required */,
'{{ team_id }}',
'{{ slug }}'
RETURNING
repository
;

Manifest

# Description fields are for documentation purposes
- name: repositories
props:
  - name: project_id
    value: "{{ project_id }}"
    description: |
      Project ID. Missing or empty values return HTTP 400.
  - name: name
    value: "{{ name }}"
    description: |
      Single Docker repository name component.
  - name: team_id
    value: "{{ team_id }}"
    description: The Team identifier to perform the request on behalf of.
    description: The Team identifier to perform the request on behalf of.
  - name: slug
    value: "{{ slug }}"
    description: The Team slug to perform the request on behalf of.
    description: The Team slug to perform the request on behalf of.

DELETE examples

delete

Schedule a repository for deletion. The repository is marked so it disappears from list/get immediately; subscriber-vcr reclaims every image (manifests, blobs, tags and rows) and finally deletes the repository row asynchronously via the VcrRepositoryRemoved event.

DELETE FROM vercel.vcr.repositories
WHERE project_id = '{{ project_id }}' --required
AND id_or_name = '{{ id_or_name }}' --required
AND team_id = '{{ team_id }}'
AND slug = '{{ slug }}'
;