---
title: "List who can use one package in the organization this request is bound to: teams, org members, and outside collaborat..."
method: GET
path: "/v1/packages/{package_id}/collaborators"
tags: ["packages"]
---

# List who can use one package in the organization this request is bound to: teams, org members, and outside collaborat...

`GET /v1/packages/{package_id}/collaborators`

## Request

- Base URL: `https://api.kody.codes`
- URL: `https://api.kody.codes/v1/packages/{package_id}/collaborators`
- Auth: HTTP bearer

List who can use one package in the organization this request is bound to: teams, org members, and outside collaborators with their preset (Use, Contribute, or Manage) and grant_id. package_id takes the package id or its kody id. You need manage access on the package. Add a team or org member, or change their preset, with packageCollaboratorSet; remove one with packageCollaboratorRemove.

Org permission: none (touches no org data).

## Path parameters

- `package_id` string, required: Package id or kody id.

## Response `200`

Success.

- object
  - `package` object, required
    - `id` string, required
    - `kody_id` string, required
    - `name` string, required
  - `collaborators` object[], required
    - `grant_id` string, required
    - `subject_type` 'user' | 'team', required
    - `subject_id` string, required
    - `kind` 'team' | 'member' | 'outside', required: team: a team in this org. member: an org member. outside: holds this grant without membership (granted elsewhere).
    - `username` string, nullable, required
    - `display_name` string, nullable, required
    - `team_slug` string, nullable, required
    - `team_name` string, nullable, required
    - `preset` 'use' | 'contribute' | 'manage', nullable, required: Null for an advanced grant; see permissions.
    - `permissions` string[], required
    - `created_at` string, required

## Other responses

- `400`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `401`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `403`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `404`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `409`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `413`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `429`: Too many requests (edge IP/token limit) or an entitlement / plan-cap limit. Wait at least `Retry-After` seconds before retrying.
- `500`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `503`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `default`: Error envelope `{ "error": { "code", "message", "details"? } }`.

---

[API](https://skmtc.dev/kody/apis/kody-api.md) · [All operations](https://skmtc.dev/kody/apis/kody-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kody/apis/kody-api/revisions/705f4f022728?raw)