---
title: "List function revisions"
method: GET
path: "/compute/funcs/{id}/revisions"
tags: ["functions"]
---

# List function revisions

`GET /compute/funcs/{id}/revisions`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/compute/funcs/{id}/revisions`
- Auth: HTTP bearer

Lists a function's ship history newest first, including per-ship failure stage and reason when recorded.

## Path parameters

- `id` string, required

## Query parameters

- `page[number]` integer
- `page[size]` integer

## Response `200`

Function revisions retrieved successfully

- RevisionListResponse
  - `meta` FunctionsObservabilityPaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer
  - `data` Revision[]
    - `record_type` string
    - `revision_id` string
    - `image` string
    - `commit_sha` string
    - `shipped_by` string
    - `shipped_at` string, date-time
    - `build_status` string
    - `deploy_status` string
    - `active` boolean
    - `failure_stage` string
    - `failure_reason` string
    - `build_ok_at` string, date-time

## Other responses

- `400`: Invalid function ID
- `401`: Unauthorized
- `404`: Function not found
- `500`: Internal server error

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/compute/funcs/:id/revisions/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/a73101b68823?raw)