AgentCore

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/gen-pro/json-schema/gen-pro-agent-core-schema.json",
  "title": "AgentCore",
  "description": "Full agent setup as returned by GET /agents/{id}/core.",
  "x-generated": "2026-11-09",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/gen-pro-openapi.yaml#/components/schemas/AgentCore",
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    },
    "brand_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "identity_type": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "brand",
        "character"
      ]
    },
    "goal": {
      "type": [
        "string",
        "null"
      ],
      "description": "Comma-separated, e.g. 'growth,authority,sales'"
    },
    "target_platforms": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "shortform": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "longform": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "onboarding_status": {
      "type": [
        "string",
        "null"
      ]
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Flat keyword list used by the monitoring cron. Auto-mirrored into `monitored` on write."
    },
    "monitored": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/MonitoredItem"
      },
      "description": "Inspiration sources — accounts, hashtags, or keywords the agent monitors for trending content."
    },
    "linked_accounts": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/LinkedAccount"
      },
      "description": "The agent's OWN brand social links. NOT the same as `monitored` (which holds sources to watch)."
    },
    "personality": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full persona text for the agent."
    },
    "default_user_voice": {
      "$ref": "#/$defs/VoiceRef"
    },
    "proof_of_genesis_enabled": {
      "type": "boolean",
      "description": "Master switch for automatic Backup to Blockchain from asset/vidsheet events."
    },
    "proof_of_genesis_auto_backup_sources": {
      "type": "array",
      "description": "Asset events that should trigger automatic Proof of Genesis backups.",
      "items": {
        "type": "string",
        "enum": [
          "generated",
          "uploaded",
          "downloaded",
          "published"
        ]
      }
    },
    "proof_of_genesis_auto_backup_asset_types": {
      "type": "array",
      "description": "Asset types eligible for automatic Proof of Genesis backup.",
      "items": {
        "type": "string",
        "enum": [
          "video",
          "image"
        ]
      }
    }
  },
  "$defs": {
    "LinkedAccount": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "url"
      ],
      "properties": {
        "id": {
          "type": "integer",
          "description": "Row id if updating an existing row. Omit when adding a new account."
        },
        "url": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        },
        "platform": {
          "type": "string",
          "maxLength": 50,
          "description": "tiktok | instagram | youtube | x | linkedin | pinterest | facebook | threads | website | other"
        },
        "display_name": {
          "type": "string",
          "maxLength": 200
        }
      }
    },
    "MonitoredItem": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "handle",
        "item_type"
      ],
      "properties": {
        "handle": {
          "type": "string",
          "minLength": 1,
          "maxLength": 300,
          "description": "For accounts — a @handle or URL. For hashtags — the tag (with or without"
        },
        "item_type": {
          "type": "string",
          "enum": [
            "account",
            "hashtag",
            "keyword"
          ]
        }
      }
    },
    "VoiceRef": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "voice_id"
      ],
      "properties": {
        "voice_id": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "source": {
          "type": "string",
          "enum": [
            "public",
            "user_designed",
            "user_trained",
            "user_elevenlabs"
          ]
        },
        "name": {
          "type": "string",
          "maxLength": 200
        }
      }
    }
  }
}