GenuineAIGenuineAI
For usersFor developers
  • Overview
  • Guides
  • How-to
  • API reference
Documentation
  • Quickstart
  • Authentication
  • Errors
  • Rate limits
  • API reference
Platform
  • Platform overview
  • Solutions
  • Pricing
  • Sign in
Company
  • Status
  • Trust Center
  • Contact
  • Terms of Service
  • Privacy Policy

© 2026 GenuineAI Ventures LLC

support@genuinehq.com
Overview
Core
Media library
AI
    Agents
    Threads
    Messages
    Spaces
    Prompts
    Prompt categories
    Wildcards
      List wildcardsgetCreate a wildcardpostGet a wildcardgetDelete a wildcarddeleteUpdate a wildcardpatch
    Memories
    Assist
Documents
Knowledge
Creative
Website & content
Automation
Customer channels
Administration
Schemas
GenuineAI API
GenuineAI API

Wildcards

Named inputs a prompt can ask for, and how each is collected.


List wildcards

GET
https://api.genuineai.app/api/v1
/wildcards

Returns the named inputs prompts can ask for, and how each one is collected.

List wildcards › query Parameters

cursor
​string · maxLength: 512 · pattern: ^[A-Za-z0-9_-]+$
limit
​integer
offset
​integer · min: 0
sort
​string · minLength: 1 · maxLength: 64 · pattern: ^-?[a-z0-9_]+$
wildcard_active
​boolean
​object · style: deepObject · explode: true
wildcard_control_type
​string
wildcard_created
​array
wildcard_description
​string
wildcard_id
​string · uuid
wildcard_managed_by
​string · uuid
wildcard_name
​string
wildcard_updated
​array

List wildcards › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

List wildcards › Responses

Success

​Wildcard[] · required
has_more
​boolean · required

Whether more rows exist past this page.

next_cursor
​string | null · required

Pass back as cursor for the next page. Null on the last page.

GET/wildcards
curl https://api.genuineai.app/api/v1/wildcards \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
{ "data": [ { "wildcard_id": "00000000-0000-0000-0000-000000000000", "wildcard_name": "wildcard_name", "wildcard_description": "wildcard_description", "wildcard_control_type": "wildcard_control_type", "wildcard_control_props": "wildcard_control_props", "wildcard_metadata": {}, "wildcard_managed_by": "wildcard_managed_by", "wildcard_active": true, "wildcard_created": "2024-08-25T15:00:00Z", "wildcard_updated": "2024-08-25T15:00:00Z" } ], "has_more": true, "next_cursor": "next_cursor" }
json
application/json

Create a wildcard

POST
https://api.genuineai.app/api/v1
/wildcards

Declares an input a prompt can ask for. The control type decides how it is collected when the prompt runs.

Create a wildcard › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Create a wildcard › Request Body

wildcard_name
​string · minLength: 1 · required
wildcard_control_type
​string · minLength: 1 · required
wildcard_description
​string
wildcard_control_props
​object

Create a wildcard › Responses

Created

A named input a prompt asks for, and how it is collected.
Wildcard
wildcard_id
​string · uuid
wildcard_name
​string
wildcard_description
​string
wildcard_control_type
​string
wildcard_control_props
​string
wildcard_metadata
​object
wildcard_managed_by
​string
wildcard_active
​boolean
wildcard_created
​string · date-time
wildcard_updated
​string · date-time
POST/wildcards
curl https://api.genuineai.app/api/v1/wildcards \ --request POST \ --header 'Content-Type: application/json' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>' \ --data '{ "wildcard_name": "wildcard_name", "wildcard_description": "wildcard_description", "wildcard_control_type": "wildcard_control_type", "wildcard_control_props": {} }'
Example Request Body
{ "wildcard_name": "wildcard_name", "wildcard_description": "wildcard_description", "wildcard_control_type": "wildcard_control_type", "wildcard_control_props": {} }
json
Example Responses
{ "wildcard_id": "00000000-0000-0000-0000-000000000000", "wildcard_name": "wildcard_name", "wildcard_description": "wildcard_description", "wildcard_control_type": "wildcard_control_type", "wildcard_control_props": "wildcard_control_props", "wildcard_metadata": {}, "wildcard_managed_by": "wildcard_managed_by", "wildcard_active": true, "wildcard_created": "2024-08-25T15:00:00Z", "wildcard_updated": "2024-08-25T15:00:00Z" }
json
application/json

Get a wildcard

GET
https://api.genuineai.app/api/v1
/wildcards/{id}

Returns one wildcard with its control type and that control's settings.

Get a wildcard › path Parameters

id
​string · uuid · required

Get a wildcard › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Get a wildcard › Responses

Success

A named input a prompt asks for, and how it is collected.
Wildcard
wildcard_id
​string · uuid
wildcard_name
​string
wildcard_description
​string
wildcard_control_type
​string
wildcard_control_props
​string
wildcard_metadata
​object
wildcard_managed_by
​string
wildcard_active
​boolean
wildcard_created
​string · date-time
wildcard_updated
​string · date-time
GET/wildcards/{id}
curl https://api.genuineai.app/api/v1/wildcards/:id \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
{ "wildcard_id": "00000000-0000-0000-0000-000000000000", "wildcard_name": "wildcard_name", "wildcard_description": "wildcard_description", "wildcard_control_type": "wildcard_control_type", "wildcard_control_props": "wildcard_control_props", "wildcard_metadata": {}, "wildcard_managed_by": "wildcard_managed_by", "wildcard_active": true, "wildcard_created": "2024-08-25T15:00:00Z", "wildcard_updated": "2024-08-25T15:00:00Z" }
json
application/json

Delete a wildcard

DELETE
https://api.genuineai.app/api/v1
/wildcards/{id}

Prompts already referencing it keep the reference, so check before removing one in use.

Delete a wildcard › path Parameters

id
​string · uuid · required

Delete a wildcard › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Delete a wildcard › Responses

Success. No content.

No data returned
DELETE/wildcards/{id}
curl https://api.genuineai.app/api/v1/wildcards/:id \ --request DELETE \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>'
Example Responses
No example specified for this content type

Update a wildcard

PATCH
https://api.genuineai.app/api/v1
/wildcards/{id}

Applies the wildcard_-prefixed fields present in the body. Prompts referencing it by name pick the change up on their next run.

Update a wildcard › path Parameters

id
​string · uuid · required

Update a wildcard › Headers

X-Tenant-Id
​string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Update a wildcard › Request Body optional

wildcard_name
​string
wildcard_active
​boolean
wildcard_control_type
​string
wildcard_control_props
​object

Update a wildcard › Responses

Success

A named input a prompt asks for, and how it is collected.
Wildcard
wildcard_id
​string · uuid
wildcard_name
​string
wildcard_description
​string
wildcard_control_type
​string
wildcard_control_props
​string
wildcard_metadata
​object
wildcard_managed_by
​string
wildcard_active
​boolean
wildcard_created
​string · date-time
wildcard_updated
​string · date-time
PATCH/wildcards/{id}
curl https://api.genuineai.app/api/v1/wildcards/:id \ --request PATCH \ --header 'Content-Type: application/json' \ --header 'X-Tenant-Id: <string>' \ --header 'X-Api-Key: <api-key>' \ --data '{ "wildcard_name": "wildcard_name", "wildcard_active": true, "wildcard_control_type": "wildcard_control_type", "wildcard_control_props": {} }'
Example Request Body
{ "wildcard_name": "wildcard_name", "wildcard_active": true, "wildcard_control_type": "wildcard_control_type", "wildcard_control_props": {} }
json
Example Responses
{ "wildcard_id": "00000000-0000-0000-0000-000000000000", "wildcard_name": "wildcard_name", "wildcard_description": "wildcard_description", "wildcard_control_type": "wildcard_control_type", "wildcard_control_props": "wildcard_control_props", "wildcard_metadata": {}, "wildcard_managed_by": "wildcard_managed_by", "wildcard_active": true, "wildcard_created": "2024-08-25T15:00:00Z", "wildcard_updated": "2024-08-25T15:00:00Z" }
json
application/json

Prompt categoriesMemories