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

# Get Project Setup Result

> Retrieves the comprehensive results of a completed project setup process, providing detailed information about your prepared project and its readiness for editing in CAMB.AI Studio.

Access the complete details of your finished project setup with this essential endpoint. Once your project setup task has completed its preparation process, this API call delivers comprehensive information about your newly configured project, including all the analysis results, configuration details, and metadata that make your content ready for creative editing in CAMB.AI Studio. Think of this as receiving your project's complete preparation report, telling you everything the system discovered and configured during the setup process.

## Understanding Project Setup Results

When you request the results of a completed project setup task, the system returns a comprehensive package that serves multiple important purposes in your content workflow. The response contains detailed information about your project's current state, the analysis results that informed the setup process, and the configuration parameters that will guide editing work in CAMB.AI Studio.

The run details section provides the foundational information that helps teams coordinate their work effectively. This includes the descriptive information you provided during setup, such as the project name and description that help identify and contextualize the work. You'll also find timing information that tracks when the project was created, which proves valuable for project management and workflow coordination. The language configuration details confirm exactly which source and target languages were configured, ensuring that everyone understands the scope of the localization work ahead.

## Accessing Your Project Setup Results

To retrieve your project setup results, you'll need the `run_id` that becomes available once your project setup task has completed successfully. This identifier serves as your unique key to access all the detailed information about your prepared project. Think of the `run_id` as your project's passport, providing access to everything the system learned and configured during the preparation process.

### Example Request with Python

Here's how to retrieve your completed project setup results using Python, with detailed explanations of what each part of the process accomplishes:

```python [expandable] theme={null}
import requests
import json
from datetime import datetime

# Configure authentication headers for API access
headers = {
    "x-api-key": "your-api-key",  # Replace with your actual API key
    "Content-Type": "application/json",
}


def get_project_setup_result(run_id):
    """
    Retrieves the comprehensive results of a finished project setup task.
    This function accesses all the detailed information about your prepared project,
    including analysis results and configuration details that inform Studio editing.

    The returned data provides everything your creative team needs to understand
    the project structure and begin effective editing work.
    """
    try:
        # Make the API request to retrieve setup results
        response = requests.get(
            f"https://client.camb.ai/apis/project-setup-result/{run_id}",
            headers=headers,
        )

        # Verify that the request completed successfully
        response.raise_for_status()

        # Parse the comprehensive project setup results
        result_data = response.json()

        # Extract key project information for workflow coordination
        run_details = result_data.get("run_details")

        return run_details

    except requests.exceptions.RequestException as e:
        print(f"Error retrieving project setup results: {e}")
        if hasattr(e, "response") and e.response is not None:
            print(f"Response content: {e.response.text}")
        return None


# Replace with your actual run_id from the completed setup task
run_id = 12345
project_results = get_project_setup_result(run_id)

# Process and display detailed project information if results were retrieved successfully
if project_results:
    project_name = project_results.get("project_name", "Unnamed Project")
    description = project_results.get("project_description")
    creation_time = project_results.get("created_at")
    duration = project_results.get("duration")
    source_language = project_results.get("source_language")
    target_languages = project_results.get("target_languages", [])
    studio_url = project_results.get("studio_url", None)

    print("\n--- Detailed Project Analysis ---")

    print(f"Run ID: {run_id}")

    print(f"Successfully retrieved setup results for: {project_name}")

    # Show project description for context understanding
    if description:
        print(f"Project description: {description}")

    # Display timing information for project management
    if creation_time:
        # Convert ISO timestamp to readable format for team coordination
        created = datetime.fromisoformat(creation_time.replace("Z", "+00:00"))
        print(f"Project created: {created.strftime('%Y-%m-%d %H:%M:%S UTC')}")

    # Display duration information for resource planning
    if duration:
        # Convert seconds to minutes and seconds for easier understanding
        minutes = int(duration // 60)
        seconds = int(duration % 60)
        print(f"Media duration: {minutes}m {seconds}s ({duration:.1f} seconds)")

    # Display organizational information for team coordination
    if team_id:
        print(f"Team ID: {team_id}")

    # Show language configuration that determines dubbing scope
    print(f"Source language ID: {source_language}")

    # Show target language details for localization planning
    print(f"Target languages: {len(target_languages)} configured")
    print("This project will create dubbed versions in each configured language")

    print("\nProject is ready for creative editing in CAMB.AI Studio")
    if studio_url:
        print(f"Your team can now access this project to begin detailed dubbing work using this URL: {studio_url}")
```

## Planning Your Next Steps

Understanding your project setup results helps you make informed decisions about the creative editing phase that follows. The information provides essential context for planning editing time, coordinating team resources, and setting realistic expectations for project completion.

The duration and complexity information helps you estimate how much creative editing time will be required to achieve your quality goals. Projects with longer duration or more complex audio structures typically require more detailed attention during the editing process, while simpler projects might progress more quickly through creative refinement.

The language configuration details help you plan resource allocation across different target languages, particularly when working with languages that have different characteristics or when your team has varying expertise across different languages. Understanding the full scope of language work ahead enables better planning for review processes and quality assurance approaches.


## OpenAPI

````yaml get /project-setup-result/{run_id}
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://client.camb.ai/apis
security: []
paths:
  /project-setup-result/{run_id}:
    get:
      tags:
        - Apis
        - Project Setup
      summary: Get Project Setup Result
      description: >-
        Retrieves the final result of a completed project setup.


        This endpoint provides access to the final results of a completed
        project setup.

        It verifies that the authenticated user has access to the requested
        run_id and

        validates that the run is of the correct type (`DUB_PROJECT`) before
        returning results.


        Note:
            This endpoint should only be called by users to retrieve their run results via API.
            Access validation is performed to ensure users can only access their own runs.

        Args:
            run_id: Positive integer ID of the project setup run.
            api_key_obj: API key authentication data from dependency.
            traceparent: OpenTelemetry trace header for distributed tracing.

        Returns:
            GetCreateProjectSetupResponse: Project setup results including run details.

        Raises:
            HTTPException:
                - 404: If the run_id is not found
                - 400: If the run type is not valid for this endpoint (must be DUB_PROJECT)
      operationId: get_project_setup_result_project_setup_result__run_id__get
      parameters:
        - name: run_id
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/RunIDParam'
          description: >-
            The unique identifier for the run, which was generated during the
            project setup process and returned upon task completion.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCreateProjectSetupResponse'
                title: >-
                  Response Get Project Setup Result Project Setup Result  Run
                  Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    RunIDParam:
      type: integer
      title: Run ID
      description: >-
        The unique identifier for the run, which was generated during the
        creation process and returned upon task completion.
    GetCreateProjectSetupResponse:
      properties:
        run_id:
          type: integer
          minimum: 0
          title: Run ID
          description: >-
            The unique identifier for the run, which was generated during the
            Project setup process and returned upon task completion.
        project_details:
          $ref: '#/components/schemas/RunDetails'
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    RunDetails:
      type: object
      properties:
        project_name:
          type: string
          title: Project Name
          minLength: 3
          maxLength: 255
          description: >-
            This represents the human-readable project identifier you provided
            when creating the project setup. Think of this as the project's
            display name that appears throughout CAMB.AI Studio, helping your
            team quickly identify which content piece they're working with.
        project_description:
          type: string
          title: Project Description
          minLength: 3
          maxLength: 5000
          nullable: true
          description: >-
            This field contains the detailed project context you provided during
            setup, serving as documentation that travels with your project
            throughout its lifecycle. The description becomes particularly
            valuable when projects move between team members or when you return
            to work after time has passed.
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            This timestamp in UTC timezone marks the exact moment your project
            setup was initiated, providing crucial information for workflow
            coordination and project management.
        source_language:
          $ref: '#/components/schemas/SourceLanguages'
          description: >-
            This identifies the original language of your media content,
            representing one of the most critical configuration decisions that
            influences every subsequent processing step.
        target_languages:
          items:
            $ref: '#/components/schemas/Languages'
          type: array
          title: Target Languages
          description: >-
            This array contains all the languages you've requested for dubbing
            output, and each entry will be available in your CAMB.AI Studio
            project.
        folder_id:
          type: integer
          minimum: 0
          nullable: true
          description: >-
            This optional field indicates the organizational folder where your
            project resides within your team's workspace structure. Think of
            this as your project's filing location within CAMB.AI Studio,
            helping maintain organized project management as your content
            library grows.
          example: <number>
        studio_url:
          type: string
          description: >-
            This field contains the direct URL link to access your project
            within CAMB.AI Studio's web interface. Once your project setup is
            complete, this URL serves as the primary entry point for all
            creative work, allowing you and your team members to navigate
            directly to the project's workspace where you can review
            transcripts, adjust timing, refine translations, and manage the
            dubbing process. 
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    SourceLanguages:
      type: integer
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
        - 8
        - 9
        - 10
        - 11
        - 12
        - 13
        - 14
        - 15
        - 16
        - 17
        - 18
        - 19
        - 20
        - 21
        - 22
        - 23
        - 24
        - 25
        - 26
        - 27
        - 28
        - 29
        - 30
        - 31
        - 32
        - 33
        - 34
        - 35
        - 36
        - 37
        - 38
        - 39
        - 40
        - 41
        - 42
        - 43
        - 44
        - 45
        - 46
        - 47
        - 48
        - 49
        - 50
        - 51
        - 52
        - 53
        - 54
        - 55
        - 56
        - 57
        - 58
        - 59
        - 60
        - 61
        - 62
        - 63
        - 64
        - 65
        - 66
        - 67
        - 68
        - 69
        - 70
        - 71
        - 73
        - 74
        - 75
        - 76
        - 78
        - 79
        - 80
        - 81
        - 82
        - 83
        - 84
        - 85
        - 86
        - 87
        - 88
        - 90
        - 91
        - 92
        - 93
        - 94
        - 95
        - 96
        - 97
        - 98
        - 99
        - 100
        - 101
        - 102
        - 103
        - 104
        - 106
        - 107
        - 108
        - 109
        - 110
        - 111
        - 112
        - 113
        - 114
        - 115
        - 116
        - 117
        - 118
        - 119
        - 120
        - 121
        - 122
        - 123
        - 124
        - 125
        - 126
        - 127
        - 128
        - 129
        - 130
        - 131
        - 132
        - 133
        - 134
        - 135
        - 136
        - 139
        - 140
        - 141
        - 142
        - 143
        - 144
        - 145
        - 146
        - 148
      default: 1
    Languages:
      type: integer
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
        - 8
        - 9
        - 10
        - 11
        - 12
        - 13
        - 14
        - 15
        - 16
        - 17
        - 18
        - 19
        - 20
        - 21
        - 22
        - 23
        - 24
        - 25
        - 26
        - 27
        - 28
        - 29
        - 30
        - 31
        - 32
        - 33
        - 34
        - 35
        - 36
        - 37
        - 38
        - 39
        - 40
        - 41
        - 42
        - 43
        - 44
        - 45
        - 46
        - 47
        - 48
        - 49
        - 50
        - 51
        - 52
        - 53
        - 54
        - 55
        - 56
        - 57
        - 58
        - 59
        - 60
        - 61
        - 62
        - 63
        - 64
        - 65
        - 66
        - 67
        - 68
        - 69
        - 70
        - 71
        - 72
        - 73
        - 74
        - 75
        - 76
        - 77
        - 78
        - 79
        - 80
        - 81
        - 82
        - 83
        - 84
        - 85
        - 86
        - 87
        - 88
        - 89
        - 90
        - 91
        - 92
        - 93
        - 94
        - 95
        - 96
        - 97
        - 98
        - 99
        - 100
        - 101
        - 102
        - 103
        - 104
        - 105
        - 106
        - 107
        - 108
        - 109
        - 110
        - 111
        - 112
        - 113
        - 114
        - 115
        - 116
        - 117
        - 118
        - 119
        - 120
        - 121
        - 122
        - 123
        - 124
        - 125
        - 126
        - 127
        - 128
        - 129
        - 130
        - 131
        - 132
        - 133
        - 134
        - 135
        - 136
        - 139
        - 140
        - 141
        - 142
        - 143
        - 144
        - 145
        - 146
        - 147
        - 148
        - 149
        - 150
      title: Languages
      default: 1
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        The `x-api-key` is a custom header required for authenticating requests
        to our API. Include this header in your request with the appropriate API
        key value to securely access our endpoints. You can find your API key(s)
        in the 'API' section of our studio website.

````