## Retrieve

**get** `/api/promptly/tasks/{taskId}`

Retrieve a specific task by ID

### Path Parameters

- `taskId: string`

### Returns

- `Task = object { id, createdAt, model, 22 more }`

  - `id: string`

  - `createdAt: string`

  - `model: string`

    AI model identifier (e.g., 'gpt-4o-mini')

  - `name: string`

    Human-readable task name

  - `prompt: string`

    The AI prompt to execute

  - `schedule: "once" or "hourly" or "daily" or "weekly"`

    Task execution frequency

    - `"once"`

    - `"hourly"`

    - `"daily"`

    - `"weekly"`

  - `status: "active" or "paused" or "completed"`

    - `"active"`

    - `"paused"`

    - `"completed"`

  - `cronExpression: optional string`

    Custom cron expression (overrides schedule settings)

  - `deliveryEmail: optional boolean`

    Email delivery enabled

  - `deliveryEmailAddress: optional string`

    Email address for delivery

  - `deliveryPhoneNumber: optional string`

    Phone number for SMS delivery

  - `deliverySms: optional boolean`

    SMS delivery enabled

  - `destinations: optional array of Destination`

    Where to deliver task results

    - `type: "email" or "sms" or "webhook"`

      - `"email"`

      - `"sms"`

      - `"webhook"`

    - `value: string`

      Email address, phone number, or webhook URL

    - `label: optional string`

      Optional human-readable label

  - `lastRunAt: optional string`

  - `nextRunAt: optional string`

  - `organizationId: optional string`

  - `scheduleDays: optional array of "monday" or "tuesday" or "wednesday" or 4 more`

    Days of week to run (for weekly schedule)

    - `"monday"`

    - `"tuesday"`

    - `"wednesday"`

    - `"thursday"`

    - `"friday"`

    - `"saturday"`

    - `"sunday"`

  - `scheduleTime: optional string`

    Time of day to run (HH:MM format)

  - `skillIds: optional array of string`

    IDs of attached skills

  - `skills: optional array of Skill`

    Attached skills (when expanded)

    - `id: string`

    - `content: string`

      Markdown instructions that guide task execution

    - `name: string`

    - `category: optional string`

    - `createdAt: optional string`

    - `description: optional string`

    - `frontmatter: optional object { author, requiredSources, tags }`

      Skill metadata

      - `author: optional string`

      - `requiredSources: optional array of string`

        Source slugs this skill depends on

      - `tags: optional array of string`

    - `iconUrl: optional string`

    - `isPublic: optional boolean`

      Whether the skill is shared publicly

    - `isUserInvocable: optional boolean`

      Whether users can manually attach this skill

    - `organizationId: optional string`

    - `slug: optional string`

      URL-friendly identifier

    - `updatedAt: optional string`

    - `version: optional number`

  - `sourceIds: optional array of string`

    IDs of attached sources

  - `sources: optional array of Source`

    Attached data sources (when expanded)

    - `id: string`

    - `config: object { args, baseUrl, command, 3 more }`

      Source-specific configuration

      - `args: optional array of string`

        Command arguments

      - `baseUrl: optional string`

        Base URL for API sources

      - `command: optional string`

        Command to run for stdio transport

      - `env: optional map[string]`

        Environment variables

      - `transport: optional "stdio" or "http" or "websocket"`

        MCP transport type

        - `"stdio"`

        - `"http"`

        - `"websocket"`

      - `url: optional string`

        URL for http/websocket transport

    - `name: string`

    - `type: "mcp" or "api" or "local"`

      Source connection type

      - `"mcp"`

      - `"api"`

      - `"local"`

    - `authConfig: optional object { headerName, prefix, provider }`

      Authentication configuration

      - `headerName: optional string`

      - `prefix: optional string`

      - `provider: optional string`

    - `authType: optional "none" or "oauth" or "bearer" or 5 more`

      - `"none"`

      - `"oauth"`

      - `"bearer"`

      - `"basic"`

      - `"header"`

      - `"query"`

      - `"api_key"`

      - `"composio"`

    - `composioConnected: optional boolean`

      Whether Composio OAuth is completed

    - `composioToolkit: optional string`

      Composio toolkit name (e.g., 'todoist', 'github')

    - `createdAt: optional string`

    - `description: optional string`

    - `iconUrl: optional string`

    - `isActive: optional boolean`

      Whether the source is connected and ready

    - `lastConnectedAt: optional string`

    - `organizationId: optional string`

    - `slug: optional string`

      URL-friendly identifier

    - `tools: optional array of Tool`

      Available tools from this source

      - `description: optional string`

      - `inputSchema: optional unknown`

        JSON Schema for tool parameters

      - `name: optional string`

    - `updatedAt: optional string`

  - `timezone: optional string`

    IANA timezone (e.g., 'America/New_York')

  - `updatedAt: optional string`

  - `userId: optional string`

    Owner user ID

### Example

```http
curl https://0ct.com/api/promptly/tasks/$TASK_ID \
    -H "Authorization: Bearer $0CT_API_KEY"
```