> ## Documentation Index > Fetch the complete documentation index at: https://portkey-docs-docs-prisma-airs-updates.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Create assistant ## OpenAPI ````yaml https://raw.githubusercontent.com/PaloAltoNetworks/openapi/refs/heads/main/openapi.yaml post /assistants openapi: 3.0.0 info: title: Prisma AIRS AI Gateway API version: 3.0.0 description: '' servers: - url: https://aigw.portkey.ai/v1 description: Managed - url: https://self-hosted-gateway-url.example.com/v1 description: Self-hosted -- replace with your own gateway host security: - Authorization: [] tags: - name: Assistants description: '' - name: Audio description: '' - name: Batch description: '' - name: Chat description: '' - name: Completions description: '' - name: Embeddings description: '' - name: Files description: '' - name: Fine-Tuning description: '' - name: Images description: '' - name: Model Pricing description: '' - name: Models description: '' - name: Moderations description: '' - name: OCR description: '' - name: Realtime description: '' - name: Rerank description: '' - name: Responses description: '' - name: Vector Stores description: '' - name: Configs description: '' - name: Guardrails description: '' - name: Integrations description: '' - name: Integrations > Models description: '' - name: Integrations > Workspaces description: '' - name: Providers description: '' - name: Secret References description: '' - name: MCP Integrations description: '' - name: MCP Integrations > Capabilities description: '' - name: MCP Integrations > Metadata description: '' - name: MCP Integrations > Workspaces description: '' - name: MCP Servers description: '' - name: MCP Servers > Capabilities description: '' - name: MCP Servers > Connections description: '' - name: MCP Servers > User Access description: '' - name: API Keys description: '' - name: Deployments description: '' - name: Org Guardrails description: '' - name: Rate Limit Policies description: '' - name: Usage Limit Policies description: '' - name: Analytics > Graphs description: '' - name: Analytics > Groups description: '' - name: Analytics > Summary description: '' - name: Feedback description: '' - name: Logs description: '' paths: /assistants: post: tags: - Assistants operationId: createAssistant requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateAssistantRequest' responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/AssistantObject' components: schemas: CreateAssistantRequest: type: object additionalProperties: false properties: model: anyOf: - type: string - type: string enum: - gpt-4o - gpt-4o-2024-05-13 - gpt-4-turbo - gpt-4-turbo-2024-04-09 - gpt-4-0125-preview - gpt-4-turbo-preview - gpt-4-1106-preview - gpt-4-vision-preview - gpt-4 - gpt-4-0314 - gpt-4-0613 - gpt-4-32k - gpt-4-32k-0314 - gpt-4-32k-0613 - gpt-3.5-turbo - gpt-3.5-turbo-16k - gpt-3.5-turbo-0613 - gpt-3.5-turbo-1106 - gpt-3.5-turbo-0125 - gpt-3.5-turbo-16k-0613 x-oaiTypeLabel: string name: type: string maxLength: 256 nullable: true description: type: string maxLength: 512 nullable: true instructions: type: string maxLength: 256000 nullable: true tools: default: [] type: array maxItems: 128 items: oneOf: - $ref: '#/components/schemas/AssistantToolsCode' - $ref: '#/components/schemas/AssistantToolsFileSearch' - $ref: '#/components/schemas/AssistantToolsFunction' x-oaiExpandable: true tool_resources: type: object properties: code_interpreter: type: object properties: file_ids: type: array default: [] maxItems: 20 items: type: string file_search: type: object properties: vector_store_ids: type: array maxItems: 1 items: type: string vector_stores: type: array maxItems: 1 items: type: object properties: file_ids: type: array maxItems: 10000 items: type: string chunking_strategy: type: object oneOf: - type: object title: Auto Chunking Strategy additionalProperties: false properties: type: type: string enum: - auto required: - type - type: object title: Static Chunking Strategy additionalProperties: false properties: type: type: string enum: - static static: type: object additionalProperties: false properties: max_chunk_size_tokens: type: integer minimum: 100 maximum: 4096 chunk_overlap_tokens: type: integer required: - max_chunk_size_tokens - chunk_overlap_tokens required: - type - static x-oaiExpandable: true metadata: type: object x-oaiTypeLabel: map oneOf: - required: - vector_store_ids - required: - vector_stores nullable: true metadata: type: object x-oaiTypeLabel: map nullable: true temperature: type: number minimum: 0 maximum: 2 default: 1 nullable: true top_p: type: number minimum: 0 maximum: 1 default: 1 nullable: true response_format: $ref: '#/components/schemas/AssistantsApiResponseFormatOption' nullable: true required: - model AssistantObject: type: object title: Assistant properties: id: type: string object: type: string enum: - assistant created_at: type: integer name: type: string maxLength: 256 nullable: true description: type: string maxLength: 512 nullable: true model: type: string instructions: type: string maxLength: 256000 nullable: true tools: default: [] type: array maxItems: 128 items: oneOf: - $ref: '#/components/schemas/AssistantToolsCode' - $ref: '#/components/schemas/AssistantToolsFileSearch' - $ref: '#/components/schemas/AssistantToolsFunction' x-oaiExpandable: true tool_resources: type: object properties: code_interpreter: type: object properties: file_ids: type: array default: [] maxItems: 20 items: type: string file_search: type: object properties: vector_store_ids: type: array maxItems: 1 items: type: string nullable: true metadata: type: object x-oaiTypeLabel: map nullable: true temperature: type: number minimum: 0 maximum: 2 default: 1 nullable: true top_p: type: number minimum: 0 maximum: 1 default: 1 nullable: true response_format: $ref: '#/components/schemas/AssistantsApiResponseFormatOption' nullable: true required: - id - object - created_at - name - description - model - instructions - tools - metadata AssistantToolsCode: type: object title: Code interpreter tool properties: type: type: string enum: - code_interpreter required: - type AssistantToolsFileSearch: type: object title: FileSearch tool properties: type: type: string enum: - file_search file_search: type: object properties: max_num_results: type: integer minimum: 1 maximum: 50 required: - type AssistantToolsFunction: type: object title: Function tool properties: type: type: string enum: - function function: $ref: '#/components/schemas/FunctionObject' required: - type - function AssistantsApiResponseFormatOption: oneOf: - type: string enum: - none - auto - $ref: '#/components/schemas/AssistantsApiResponseFormat' x-oaiExpandable: true FunctionObject: type: object properties: description: type: string name: type: string parameters: $ref: '#/components/schemas/FunctionParameters' strict: type: boolean default: false nullable: true required: - name AssistantsApiResponseFormat: type: object properties: type: type: string enum: - text - json_object default: text FunctionParameters: type: object additionalProperties: true securitySchemes: Authorization: type: http scheme: bearer ````