List Actions

GET/actions

Returns every available action as an object keyed by action name. Each entry tells you whether the action supports the type filter (has_types) and lists any aliases that resolve to it.

Use this metadata to decide when to show type filters in your UI and to surface alias names to your users.

Response fields

Field	Type	Description
actions	object	Map of action name → action metadata
actions[name].has_types	boolean	Whether this action supports `type` filtering
actions[name].aliasesoptional	object[]	Aliases that resolve to this action
actions[name].aliases[].alias	string	The alias name (callable as `GET /{alias}`)
actions[name].aliases[].typeoptional	string	If set, the alias is locked to this `type` of the action

Example request

curl https://api.gifukai.com/actions

Example response

{
  "actions": {
    "hug": { "has_types": false },
    "nya": {
      "has_types": false,
      "aliases": [
        { "alias": "meow" },
        { "alias": "neko" }
      ]
    },
    "kiss": {
      "has_types": true,
      "aliases": [
        { "alias": "peck", "type": "cheek" }
      ]
    }
  }
}

Here meow and neko both resolve to nya, and peck resolves to kiss locked to the cheek type. See All Actions & Aliases for the full list, and Action Types to fetch the valid type values for a typed action.

Status codes

Status	Description
200	Successfully returned the list of actions
500	Internal server error