> ## Documentation Index > Fetch the complete documentation index at: https://docs.roughy.ai/llms.txt > Use this file to discover all available pages before exploring further. # List projects > Paginated list of your projects, newest first. ## OpenAPI ````yaml https://roughy-api-staging.fly.dev/v1/openapi.json get /v1/projects openapi: 3.1.0 info: title: Roughy Public API version: 0.0.0 servers: - url: https://roughy-api-staging.fly.dev description: Staging security: [] tags: - name: Projects description: >- Workflow containers. Every asset lives inside a project; a project groups everything for one piece of work (an episode, an interview, a talk). - name: Assets description: >- The unit of media. `POST /assets` creates one and opens its upload in a single call: the response body is the asset (its `upload_url` carries the transfer URL while `pending_upload`), and the TUS transfer URL also comes back in the `Location` header. List, detail (with signed download URL), and delete round it out. Each asset belongs to exactly one project; `language` is set at create and immutable. - name: Uploads description: >- Drive the TUS-resumable transfer that streams an asset's bytes. `POST /assets` opens the upload; `PATCH`/`HEAD` move and resume the bytes, `DELETE` cancels (removing the asset). Lost the transfer URL? Re-`GET` the asset — while it's `pending_upload`, `upload_url` carries it. - name: Cuts description: >- A kept-segment plan for an asset, computed automatically by Roughy. Create one with `POST /cuts {asset_id, script?}`, list with `GET /cuts`, read a cut, export it to NLE formats, and export its generated subtitle (SRT / VTT). - name: Renders description: >- Renders an asset to a video (`mp4`/`mov`) or audio (`m4a`/`mp3`) output, optionally applying a `cut_id`. `POST /renders {asset_id, cut_id?, output}` creates one; list, read (with a signed download URL), and cancel as a top-level `/renders` resource. - name: Webhooks description: >- Register endpoints to receive signed terminal-state events (cut / render / asset) instead of polling. - name: Credits description: Credit balance and usage history. - name: Users description: Your account and profile. - name: OAuth description: >- Device authorization grant (RFC 8628), served at app.roughy.ai/oauth/* for the editor plugin. Internal surface — not part of the public /v1 SDK. - name: billing description: Stripe customer portal, invoices, subscriptions. - name: api-keys description: Mint and revoke API keys. - name: auth description: Sign up, log in, log out, and OAuth flows for the dashboard. - name: webhooks description: Inbound provider webhooks (Stripe, Resend, ElevenLabs). - name: email-preferences description: Per-category transactional-email opt-out preferences. - name: sse description: Server-sent live updates per asset. - name: health description: Liveness and readiness probes. paths: /v1/projects: get: tags: - Projects summary: List projects description: Paginated list of your projects, newest first. operationId: list_projects_v1_projects_get parameters: - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Maximum number of items to return (1-100). Defaults to 20. default: 20 title: Limit description: Maximum number of items to return (1-100). Defaults to 20. - name: offset in: query required: false schema: type: integer minimum: 0 description: >- Number of items to skip from the start of the listing. Defaults to 0. default: 0 title: Offset description: >- Number of items to skip from the start of the listing. Defaults to 0. - name: state in: query required: false schema: anyOf: - type: string enum: - active - archived - type: 'null' description: Filter by lifecycle state. Defaults to `active`. title: State description: Filter by lifecycle state. Defaults to `active`. responses: '200': description: One page of projects, newest first. content: application/json: schema: $ref: '#/components/schemas/ProjectListResponse' security: - HTTPBearer: [] components: schemas: ProjectListResponse: properties: items: items: $ref: '#/components/schemas/ProjectSummary' type: array title: Items description: Page of projects, newest first. total: type: integer title: Total description: >- Total number of projects matching the filter across all pages — not the size of `items`. limit: type: integer title: Limit description: The `limit` echoed back from the request. offset: type: integer title: Offset description: The `offset` echoed back from the request. type: object required: - items - total - limit - offset title: ProjectListResponse description: Paginated list of projects, newest first. example: items: - created_at: '2026-05-02T08:54:52.423000Z' id: 019de7f5-7e21-7402-92a8-1c0e1fa84411 name: Episode 42 state: active updated_at: '2026-05-02T08:54:52.423000Z' total: 1 limit: 50 offset: 0 ProjectSummary: properties: id: type: string format: uuid title: Id description: Project id. name: type: string title: Name description: Display name. state: type: string enum: - active - archived title: State description: Lifecycle state. archived_at: anyOf: - type: string format: date-time - type: 'null' title: Archived At description: When the project was archived. created_at: type: string format: date-time title: Created At description: When the project was created. updated_at: type: string format: date-time title: Updated At description: When any field last changed. type: object required: - id - name - state - archived_at - created_at - updated_at title: ProjectSummary description: A project. example: id: 019de7f5-7e21-7402-92a8-1c0e1fa84411 name: Episode 42 state: active archived_at: null created_at: '2026-05-02T08:54:52.423000Z' updated_at: '2026-05-02T08:54:52.423000Z' securitySchemes: HTTPBearer: type: http description: >- Pass your API key as `Authorization: Bearer sk_…`. Mint a key from your dashboard's API-keys page. scheme: bearer bearerFormat: sk_… ````