List name themes

GET

/api/themes

curl --request GET \
  --url https://app.nurseshark.org/api/themes \
  --header 'Authorization: Bearer <token>'

The themed name lists (sharks, birds, constellations, …) that names are drawn from. They’re shared by every account.

Same as the list_name_themes MCP tool.

Authorizations

• token

Responses

200

OK

Media typeapplication/json

object

themes

required

Array<object>

object

key

required

Pass it as theme to suggest names from this list.

string

title

required

string

description

string

size

required

How many names the list has.

integer

source

Where the names came from.

string format: uri

Example ^generated

{
  "themes": [
    {
      "key": "example",
      "title": "example",
      "description": "example",
      "size": 1,
      "source": "https://example.com"
    }
  ]
}

401

The token is missing, invalid or expired.

Media typeapplication/json

object

error

required

What went wrong and what to change.

string

errors

For validation failures, the messages for each field.

object

key

additional properties

Array<string>

Example ^generated

{
  "error": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  }
}

429

Over the rate limit. Try again in a minute.

Media typeapplication/json

object

error

required

What went wrong and what to change.

string

errors

For validation failures, the messages for each field.

object

key

additional properties

Array<string>

Example ^generated

{
  "error": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  }
}