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

# Poll age-modifier job status

> Returns the current status of an age-modifier job by its ID. `output_urls` and `credits_deducted` appear only when `status` is `completed`; `error` appears only when `status` is `failed`.

Since `POST /api/v2/apps/age-modifier` already waits for the result, use this endpoint to re-fetch outputs of an earlier job, or to check on one whose connection dropped.




## OpenAPI

````yaml /openapi.yaml get /api/v2/apps/age-modifier/{jobId}
openapi: 3.0.3
info:
  title: GoStudio API
  version: 2.0.0
  description: >
    The GoStudio v2 REST API. Every response uses a standard envelope: successes
    return `{ status, data }`; errors return `{ status, error: { type, code,
    message } }`.


    All endpoints require a **Bearer token** in the `Authorization` header. The
    one exception is the provider webhook callback, which is authenticated by
    signature.
servers:
  - url: https://www.gostudio.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Watermark Remover
    description: AI watermark removal — orchestration, model metadata, and job polling.
  - name: Photo
    description: >-
      AI photo generation — generate, recreate, and manage trained profile
      photos.
  - name: Image
    description: Image utilities — group photo composition and image-to-prompt analysis.
  - name: Media
    description: Media upload and CDN management.
  - name: Apps
    description: GoStudio application tools — age modifier and other transformations.
  - name: Job Status
    description: Generic job polling — works across all GoStudio tools.
  - name: Webhooks
    description: Endpoints called by external services, not by your application.
paths:
  /api/v2/apps/age-modifier/{jobId}:
    get:
      tags:
        - Apps
      summary: Poll age-modifier job status
      description: >
        Returns the current status of an age-modifier job by its ID.
        `output_urls` and `credits_deducted` appear only when `status` is
        `completed`; `error` appears only when `status` is `failed`.


        Since `POST /api/v2/apps/age-modifier` already waits for the result, use
        this endpoint to re-fetch outputs of an earlier job, or to check on one
        whose connection dropped.
      operationId: getAgeModifierJob
      parameters:
        - name: jobId
          in: path
          required: true
          description: Positive integer job ID returned by POST /api/v2/apps/age-modifier.
          schema:
            type: integer
            example: 12345
      responses:
        '200':
          description: Job status returned successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                  data:
                    $ref: '#/components/schemas/AgeModifierJobResult'
        '400':
          description: jobId is not a positive integer.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: 400
                error:
                  type: invalid_input
                  code: 40012
                  message: jobId must be a positive integer.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Job not found or not owned by the authenticated user.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: 404
                error:
                  type: job_not_found
                  code: 40404
                  message: Job not found.
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    AgeModifierJobResult:
      type: object
      properties:
        job_id:
          type: integer
          description: Numeric job ID.
          example: 12345
        status:
          type: string
          enum:
            - processing
            - completed
            - failed
          description: >
            Current state of the job. `output_urls` and `credits_deducted` are
            present only when `completed`; `error` is present only when
            `failed`.
        output_urls:
          type: array
          description: >-
            CDN URLs for the generated images. Present when `status` is
            `completed`.
          items:
            type: string
            format: uri
          nullable: true
        credits_deducted:
          type: integer
          description: Credits spent. Present when `status` is `completed`.
          nullable: true
          example: 10
        credit_balance:
          type: integer
          description: Remaining credit balance. Present when `status` is `completed`.
          nullable: true
          example: 490
        error:
          type: string
          description: Failure reason. Present when `status` is `failed`.
          nullable: true
        created_at:
          type: string
          format: date-time
          description: When the job was created.
        updated_at:
          type: string
          format: date-time
          description: When the job was last updated.
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          example: 400
        error:
          type: object
          properties:
            type:
              type: string
              example: validation_error
            code:
              type: string
              example: invalid_input
            dev:
              type: integer
              example: 40001
            message:
              type: string
              example: Some information is invalid.
  responses:
    Unauthorized:
      description: Missing or invalid Authorization Bearer token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: 401
            error:
              type: authentication_error
              code: unauthorized
              dev: 40100
              message: Missing or invalid Authorization Bearer token.
    RateLimited:
      description: Too many requests.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: 429
            error:
              type: rate_limit_error
              code: rate_limited
              dev: 42900
              message: You're doing that too often. Please wait a moment.
    ServerError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: 500
            error:
              type: system_error
              code: internal_error
              dev: 50000
              message: Something went wrong on our end.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Supabase user JWT (or an internal service token). Send as
        `Authorization: Bearer <token>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.