> ## Documentation Index > Fetch the complete documentation index at: https://docs.lumisreach.com/llms.txt > Use this file to discover all available pages before exploring further. # Start a Quick AI Text conversation > Has an AI agent text one or more phone numbers and keep the conversation going until the goal is met. No phone-number purchase is required — messages are sent from a shared LumisReach number that is already registered on the approved LumisReach A2P 10DLC campaign. Supply `first_message` or let the agent write the opener from the goal. STOP is honored automatically. Shared numbers have a daily volume ceiling (500 messages) so carriers do not throttle the shared campaign; a job spreads across the pool and each destination reports the `from_number` it used. Billing: $0.05 per outbound message (opener and every AI reply; inbound replies are free), charged to the wallet of the organization that owns the API key. Returns 409 when the shared pool has no daily volume left. ## OpenAPI ````yaml /openapi.json post /v1/quick/ai-texts openapi: 3.1.0 info: title: LumisReach v1 API version: 1.0.0 description: >- Programmatic access to the LumisReach voice platform — calls, numbers, caller trust, and brands. contact: name: LumisReach email: founders@lumisreach.com servers: - url: https://api.lumisreach.com/api security: - bearerAuth: [] tags: - name: Phone Numbers - name: Caller IDs - name: Enterprise Registration - name: Branded Calling - name: Calls - name: SMS - name: WebRTC - name: Reputation - name: Usage - name: Account - name: Documents - name: Quick Agent Actions - name: Sub-entities paths: /v1/quick/ai-texts: post: tags: - Quick Agent Actions summary: Start a Quick AI Text conversation description: >- Has an AI agent text one or more phone numbers and keep the conversation going until the goal is met. No phone-number purchase is required — messages are sent from a shared LumisReach number that is already registered on the approved LumisReach A2P 10DLC campaign. Supply `first_message` or let the agent write the opener from the goal. STOP is honored automatically. Shared numbers have a daily volume ceiling (500 messages) so carriers do not throttle the shared campaign; a job spreads across the pool and each destination reports the `from_number` it used. Billing: $0.05 per outbound message (opener and every AI reply; inbound replies are free), charged to the wallet of the organization that owns the API key. Returns 409 when the shared pool has no daily volume left. operationId: v1_quick_ai_texts_post parameters: - name: Idempotency-Key in: header required: false description: >- UUID — when present, deduplicates repeat submissions. See /api-reference/idempotency. schema: type: string requestBody: required: true content: application/json: schema: $schema: http://json-schema.org/draft-07/schema# type: object properties: to_numbers: minItems: 1 maxItems: 20 type: array items: type: string pattern: ^\+[1-9]\d{1,14}$ description: Destination in E.164 format description: One or more destinations in E.164 format goal: type: string minLength: 10 maxLength: 2000 description: >- What the AI should accomplish over the thread. Drives the system prompt. first_message: type: string minLength: 1 maxLength: 1200 instructions: type: string maxLength: 4000 language: default: en type: string maxLength: 10 max_messages: default: 5 type: integer minimum: 1 maximum: 20 reply_delay_seconds: default: 0 type: integer minimum: 0 maximum: 300 conversation_timeout_hours: default: 48 type: integer minimum: 1 maximum: 168 contact_name: type: string maxLength: 120 required: - to_numbers - goal - language - max_messages - reply_delay_seconds - conversation_timeout_hours additionalProperties: false responses: '200': description: Success content: application/json: schema: $schema: http://json-schema.org/draft-07/schema# type: object properties: data: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ kind: type: string const: ai_text status: type: string from_number: type: string target_count: type: number status_url: type: string pricing: type: object properties: per_message_usd: type: number note: type: string required: - per_message_usd - note additionalProperties: false required: - id - kind - status - from_number - target_count - status_url - pricing additionalProperties: false required: - data additionalProperties: false '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '409': description: Conflict (incl. idempotency conflicts) content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '429': description: Rate limited content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: schemas: ErrorEnvelope: type: object properties: error: type: object required: - code - message properties: code: type: string message: type: string fields: type: object additionalProperties: type: string doc_url: type: string format: uri securitySchemes: bearerAuth: type: http scheme: bearer ````