> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altrina.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get actions taken in a job

> Get all actions taken by the browser agent during a job execution.

Returns a chronologically ordered list of all actions performed, including action details, parameters, results (excluding screenshots), and evaluation data. Use this to understand the step-by-step execution of your browser automation task.

Screenshot data is excluded from the result field to keep response sizes manageable.



## OpenAPI

````yaml get /v1/get_job_actions/{job_id}
openapi: 3.1.0
info:
  title: Altrina Browser Agent API
  description: >

    AI-powered browser automation API that allows you to control web browsers
    programmatically.


    ## What can Altrina do?


    Altrina uses advanced AI models to understand natural language instructions
    and execute them in a web browser:

    - **Web Scraping**: Extract data from any website without writing selectors

    - **Form Automation**: Fill out complex forms and multi-step workflows

    - **Testing**: Automated end-to-end testing with natural language assertions

    - **Research**: Gather information across multiple sites and compile results

    - **Monitoring**: Check websites for changes or specific conditions


    ## Authentication

    All API endpoints (except `/v1/health`) require authentication via API key.


    ### Getting an API Key

    1. Go to
    [https://app.altrina.com/settings](https://app.altrina.com/settings)

    2. Click on "Generate API Key"

    3. Copy your API key and keep it secure


    ### Using the API Key

    Include your API key in the `Authorization` header as a Bearer token:

    ```

    Authorization: Bearer YOUR_API_KEY

    ```


    ### Example cURL Request

    ```bash

    curl -X POST "https://api.altrina.com/v1/run_browser_agent" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "directive": "Go to news.ycombinator.com and get the titles and points of the top 3 stories on the homepage",
        "browser_config": {
          "width": 1920,
          "height": 1080,
          "residential_ip": false,
          "keep_browser_open": false,
          "use_user_browser_profile": false
        }
      }'
    ```


    **Note on Browser Profiles**: By default (`use_user_browser_profile:
    false`), each API call uses a fresh browser profile with no cookies or
    browsing history. Set `use_user_browser_profile: true` if you need to
    maintain logged-in state across multiple API calls.


    ## Rate Limits


    - **Browser Agent**: 10 requests/minute

    - **Status Polling**: 60 requests/minute

    - **Credit Balance**: 60 requests/minute


    ## Support


    For issues or questions, contact support@altrina.com
  version: 1.0.0
servers:
  - url: https://api.altrina.com
security: []
tags:
  - name: Browser Agent
    description: Start and monitor browser automation tasks
  - name: Workflows
    description: Trigger saved workflows via API or webhook
  - name: Account
    description: Manage credits and subscription
  - name: System
    description: Service health and status
paths:
  /v1/get_job_actions/{job_id}:
    get:
      tags:
        - Browser Agent
      summary: Get actions taken in a job
      description: >-
        Get all actions taken by the browser agent during a job execution.


        Returns a chronologically ordered list of all actions performed,
        including action details, parameters, results (excluding screenshots),
        and evaluation data. Use this to understand the step-by-step execution
        of your browser automation task.


        Screenshot data is excluded from the result field to keep response sizes
        manageable.
      operationId: get_job_actions_v1_get_job_actions__job_id__get
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            description: The unique job ID to get actions for
            title: Job Id
          description: The unique job ID to get actions for
      responses:
        '200':
          description: Actions retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobActionsResponse'
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Job not found or doesn't belong to user
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    JobActionsResponse:
      properties:
        job_id:
          type: string
          title: Job Id
          description: The job ID these actions belong to
        action_count:
          type: integer
          title: Action Count
          description: Number of actions taken in this job
        actions:
          items:
            $ref: '#/components/schemas/ActionResponse'
          type: array
          title: Actions
          description: List of actions ordered by creation time
      type: object
      required:
        - job_id
        - action_count
        - actions
      title: JobActionsResponse
      description: Response containing all actions taken in a job
    ErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Detailed error message
        status_code:
          type: integer
          title: Status Code
          description: HTTP status code
      type: object
      required:
        - detail
        - status_code
      title: ErrorResponse
      description: Standard error response format
    ActionResponse:
      properties:
        action_id:
          type: string
          title: Action Id
          description: Unique identifier for this action
        job_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Job Id
          description: The job this action belongs to
        action_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Action Name
          description: Name of the action (e.g., 'click', 'type', 'scroll')
        action_params:
          anyOf:
            - type: object
            - type: 'null'
          title: Action Params
          description: Parameters passed to the action
        story_line:
          anyOf:
            - type: string
            - type: 'null'
          title: Story Line
          description: Human-readable description of what the action did
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
          description: 'Action status: pending, awaiting_confirmation, completed, failed'
        result:
          anyOf:
            - type: object
            - type: 'null'
          title: Result
          description: Result data from the action (screenshot data excluded)
        goal:
          anyOf:
            - type: string
            - type: 'null'
          title: Goal
          description: The goal of this action
        evaluation:
          anyOf:
            - type: object
            - type: 'null'
          title: Evaluation
          description: Evaluation results (e.g., goal_achieved)
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
          description: When the action was created (ISO8601)
        updated_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Updated At
          description: When the action was last updated (ISO8601)
        webpage_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Webpage Url
          description: URL of the webpage when action was taken
        bounding_boxes:
          anyOf:
            - type: string
            - type: 'null'
          title: Bounding Boxes
          description: Visual bounding boxes data
      type: object
      required:
        - action_id
      title: ActionResponse
      description: Individual action taken by the browser agent
  securitySchemes:
    HTTPBearer:
      type: http
      description: >-
        API key for authentication. Get your API key at
        https://app.altrina.com/settings
      scheme: bearer

````