List gists

GET/gists

Lists gists owned by the authenticated caller. Visibility depends on the token's scope:

Token with gist:read → all of the caller's own gists (public, unlisted and private).
Token without gist:read → only the caller's own public gists.
Anonymous (no token) → all public gists from everyone, matching GET /gists/public.

Results are a JSON array; pagination is conveyed via the Link and X-* response headers (see the response headers below).

Request

Headers

Name	Type	Scopes
`Authorization`optional	`string`

Query parameters

Name	Type	Description
`page`	`integer`	Page number, 1-based. (default: 1, min: 1)
`per_page`	`integer`	Items per page. (default: 30, min: 1, max: 100)
`since`	`string <date-time>`	Only return gists updated at or after this RFC 3339 timestamp.

Responses

Status	Body	Description
`200`	`GistSimple`[]	A list of gists.
	Headers:`LinkX-PageX-Per-PageX-TotalX-Total-Pages`
`400`	`Error`	The request was malformed.

Request

bash

curl -X GET \
  --url "https://opengist.example.com/api/gists?page=1&per_page=30" \
  -H "Authorization: Bearer og_xxxxxxxx"

Response 200

json

[
  {
    "id": "string",
    "slug_url": "string",
    "owner": {
      "id": 1,
      "login": "string",
      "username": "string",
      "avatar_url": "https://opengist.example/...",
      "type": "string",
      "created_at": "2024-01-01T00:00:00Z"
    },
    "title": "string",
    "html_url": "https://opengist.example/...",
    "description": "string",
    "public": true,
    "visibility": "public",
    "like_count": 1,
    "fork_count": 1,
    "clone_url": "https://opengist.example/...",
    "ssh_url": "string",
    "topics": [
      "string"
    ],
    "created_at": "2024-01-01T00:00:00Z",
    "updated_at": "2024-01-01T00:00:00Z"
  }
]