### Create Project PHP Example

Source: https://www.stainless.com/docs/api/php/resources/projects/methods/create

Demonstrates how to instantiate the client and call the `create` method to add a new project. Ensure you have the SDK installed via Composer.

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'My API Key', environment: 'staging');

$project = $client->projects->create(
  displayName: 'display_name',
  org: 'org',
  revision: ['foo' => ['content' => 'content']],
  slug: 'slug',
  targets: [Target::NODE],
);

var_dump($project);

```

--------------------------------

### List Builds Response Example

Source: https://www.stainless.com/docs/api/go/resources/builds/methods/list

This is an example of the JSON response when listing builds. It includes details about each build target's status and installation URLs.

```json
{
  "data": [
    {
      "id": "build_id_1",
      "type": "build",
      "attributes": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    {
      "id": "build_id_2",
      "type": "build",
      "attributes": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}
```

--------------------------------

### List Organizations PHP Example

Source: https://www.stainless.com/docs/api/php/resources/orgs/methods/list

Demonstrates how to initialize the client and list organizations using the PHP SDK. Ensure you have the SDK installed via Composer.

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'My API Key', environment: 'staging');

$orgs = $client->orgs->list();

var_dump($orgs);

```

--------------------------------

### Install and Build SDK

Source: https://www.stainless.com/docs/sdks/typescript

Install dependencies and build the SDK before publishing. Navigate to the `dist` directory afterward.

```bash
pnpm install
pnpm build
```

```bash
cd dist
```

--------------------------------

### Configuration Response Example

Source: https://www.stainless.com/docs/api/php/resources/projects/subresources/configs/methods/retrieve

This is an example of a successful response when retrieving configuration files.

```json
{
  "foo": {
    "content": "content"
  }
}

```

--------------------------------

### Install Go SDK

Source: https://www.stainless.com/docs/api

Install the Stainless API SDK for Go.

```bash
go get -u 'github.com/stainless-api/stainless-api-go@v0.30.0'
```

--------------------------------

### Configure SDK Readme Example Requests

Source: https://www.stainless.com/docs/configure/readme

Define default, headline, and pagination example requests for an SDK's README.md. The headline example should represent the most important endpoint, pagination is for paginated endpoints, and the default is inherited by others.

```yaml
readme:
  example_requests:
    default:
      type: request
      endpoint: post /cards
      params:
        type: SINGLE_USE
    headline:
      type: request
      endpoint: put /cards
      params:
        type: SINGLE_USE
        account_id: 123
    pagination:
      type: request
      endpoint: get /cards
      params:
        limit: 30
```

--------------------------------

### Install CLI Locally

Source: https://www.stainless.com/docs/cli

Build and install the CLI tool to your Go bin directory using `go install`. This allows you to run the CLI directly from your terminal.

```bash
go install ./cmd/my-tool
```

```bash
my-tool --version
```

--------------------------------

### Install with aiohttp Backend

Source: https://www.stainless.com/docs/api/python

Install the library with the `aiohttp` extra for improved concurrency. This command installs from the staging repository.

```bash
pip install 'stainless_v0[aiohttp] @ git+ssh://git@github.com/stainless-sdks/stainless-v0-python.git'
```

--------------------------------

### Install CLI with Homebrew

Source: https://www.stainless.com/docs/cli

Recommended installation method for most users on macOS and Linux.

```bash
brew install your-org/tools/your-tool
```

--------------------------------

### Retrieve Build Example

Source: https://www.stainless.com/docs/api/kotlin/resources/builds/methods/retrieve

Example of a build object response. This shows the status of various build-related tasks.

```json
{
  "commit": {
    "status": "not_started"
  },
  "install_url": "install_url",
  "object": "build_target",
  "status": "not_started",
  "build": {
    "status": "not_started"
  },
  "lint": {
    "status": "not_started"
  },
  "test": {
    "status": "not_started"
  }
}

```

--------------------------------

### User Get Response Example

Source: https://www.stainless.com/docs/api/php/resources/user/methods/retrieve

This is an example of the JSON response structure you can expect when retrieving user information.

```json
{
  "id": "id",
  "email": "email",
  "github": {
    "username": "username"
  },
  "name": "name",
  "object": "user"
}

```

--------------------------------

### Get Installed Package Version

Source: https://www.stainless.com/docs/api/python

Determine the currently installed version of the Stainless library at runtime by accessing the `__version__` attribute.

```python
import stainless_v0
print(stainless_v0.__version__)
```

--------------------------------

### Create Project C# Example

Source: https://www.stainless.com/docs/api/csharp/resources/projects/methods/create

Demonstrates how to create a new project using the C# client library. Ensure the client is initialized and parameters are correctly set.

```csharp
ProjectCreateParams parameters = new()
{
    DisplayName = "display_name",
    Org = "org",
    Revision = new Dictionary<string, FileInput>()
    {
        { "foo", new Content("content") }
    },
    Slug = "slug",
    Targets =
    [
        Target.Node
    ],
};

var project = await client.Projects.Create(parameters);

Console.WriteLine(project);
```

--------------------------------

### Start Local Development Server

Source: https://www.stainless.com/docs/docs-platform/quickstart

Build your site and start a local web development server to preview changes. Access the site via the provided URL (e.g., http://localhost:4321).

```bash
pnpm dev
```

--------------------------------

### Automatic Pagination for list_ Methods

Source: https://www.stainless.com/docs/sdks/configure/pagination

Methods starting with 'list_' are automatically paginated by default. This configuration shows examples of such methods.

```yaml
resources:
  accounts:
    methods:
      list_accounts: get /accounts  # Automatically paginated due to list_ prefix
      list_transactions: get /transactions  # Also automatically paginated
```

--------------------------------

### Example Method Configuration

Source: https://www.stainless.com/docs/reference/config

Configure an example method to demonstrate API endpoint usage. Specify the endpoint, parameters, and how to assign the result.

```yaml
type: "request"
endpoint: "post /v1/customers"
params:
  query_param: "foo"
  body_param: true
  path_param: "id"
assign_to: "customer"
```

--------------------------------

### List Projects PHP Example

Source: https://www.stainless.com/docs/api/php/resources/projects/methods/list

Demonstrates how to instantiate the client and call the list projects method with optional parameters. Ensure the autoloader is required.

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'My API Key', environment: 'staging');

$page = $client->projects->list(cursor: 'cursor', limit: 1, org: 'org');

var_dump($page);

```

--------------------------------

### Install Stainless Go API Library

Source: https://www.stainless.com/docs/api/go

Import the library for use in your Go project. To pin a specific version, use the `go get` command.

```go
import (
	"github.com/stainless-api/stainless-api-go" // imported as stainless
)
```

```go
go get -u 'github.com/stainless-api/stainless-api-go@v0.30.0'
```

--------------------------------

### Get Build Diagnostics in Go

Source: https://www.stainless.com/docs/api/go/resources/builds/subresources/diagnostics/methods/list

Use this Go code to retrieve diagnostics for a build. Ensure you have the stainless-api-go library installed and provide your API key.

```go
package main

import (
  "context"
  "fmt"

  "github.com/stainless-api/stainless-api-go"
  "github.com/stainless-api/stainless-api-go/option"
)

func main() {
  client := stainless.NewClient(
    option.WithAPIKey("My API Key"),
  )
  page, err := client.Builds.Diagnostics.List(
    context.TODO(),
    "buildId",
    stainless.BuildDiagnosticListParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}
```

--------------------------------

### Install Dependencies and Build SDK

Source: https://www.stainless.com/docs/targets/typescript

Run these commands in your SDK's production repository to install dependencies and build the project before publishing.

```bash
pnpm install
pnpm build
```

--------------------------------

### Combining wildcards and filters

Source: https://www.stainless.com/docs/openapi/transforms/reference

Uses a combination of wildcards and filters to target specific elements. This example selects parameters named 'limit' from 'get' operations across all paths.

```yaml
target: '$.paths.*.get.parameters[?(@.name == "limit")]'
```

--------------------------------

### Basic Usage Example

Source: https://www.stainless.com/docs/api/java

Instantiate the Stainless client and create a build. Configuration is automatically handled using system properties or environment variables.

```java
import com.stainless.api.client.StainlessClient;
import com.stainless.api.client.okhttp.StainlessOkHttpClient;
import com.stainless.api.models.builds.Build;
import com.stainless.api.models.builds.BuildCreateParams;

// Configures using the `stainless.apiKey` and `stainless.baseUrl` system properties
// Or configures using the `STAINLESS_API_KEY` and `STAINLESS_BASE_URL` environment variables
StainlessClient client = StainlessOkHttpClient.fromEnv();

BuildCreateParams params = BuildCreateParams.builder()
    .project("stainless")
    .revision("main")
    .build();
Build build = client.builds().create(params);
```

--------------------------------

### Go SDK Usage Example

Source: https://www.stainless.com/docs/sdks/configure

Shows how to interact with the generated Go SDK for a todo list API, demonstrating resource, method, and model usage.

```go
client := todoninja.NewClient()


var task* todoninja.Task // from `task` model
var err error
//  from `tasks` resource
//                   |
//                   V
task, err = client.Tasks.New(context.TODO(), todoninja.TaskNewParams{
//                       ^
//                       └ from `create` method (more on method names below)
  Deadline: todoninja.Time(time.Now()),
  Name: "Grocery shopping",
})


// from `tags` subresource of `tasks`
//            |
//            V
client.Tasks.Tags.List(context.TODO(), task_id)
```

--------------------------------

### TypeScript Build Target Example

Source: https://www.stainless.com/docs/api/php/resources/builds/methods/create

This JSON object represents a build target specifically for TypeScript projects. It includes fields for commit status, installation URL, and the status of build, lint, and test phases.

```json
{
  "typescript": {
    "commit": {
      "status": "not_started"
    },
    "install_url": "install_url",
    "object": "build_target",
    "status": "not_started",
    "build": {
      "status": "not_started"
    },
    "lint": {
      "status": "not_started"
    },
    "test": {
      "status": "not_started"
    }
  }
}
```

--------------------------------

### Automated GitHub Secrets Setup Script

Source: https://www.stainless.com/docs/cli

This script configures GitHub repository secrets for Apple notarization. It requires the GitHub CLI to be installed and authenticated. It defaults to the 'production' environment unless specified otherwise.

```bash
#!/usr/bin/env bash
# Configure a GitHub repository with Apple notarization secrets for GoReleaser.
#
# Usage:
#   ./setup-notarize.sh [OWNER/REPO] [ENVIRONMENT]
#
# If OWNER/REPO is omitted, the current git remote origin is used.
# If ENVIRONMENT is omitted, defaults to 'production'. Pass "" to store
# secrets as plain repository secrets instead of environment-scoped.
# Requires the `gh` CLI to be authenticated.


set -euo pipefail


# ── helpers ──────────────────────────────────────────────────────────────────


die()  { echo "error: $*" >&2; exit 1; }
info() { echo "  $*"; }
ask()      { printf "%s: " "$1" >&2; read -r  REPLY; echo "${REPLY/#	/$HOME}"; }
ask_path() { printf "%s: " "$1" >&2; read -re REPLY; echo "${REPLY/#	/$HOME}"; }
ask_secret() {
    printf "%s: " "$1" >&2
    read -rs REPLY
    echo >&2
    echo "$REPLY"
}


# ── repo detection ────────────────────────────────────────────────────────────


if [[ $# -ge 1 ]]; then
    REPO="$1"
else
    REMOTE=$(git remote get-url origin 2>/dev/null) || die "No git remote 'origin' found and no OWNER/REPO argument given."
    # Normalize SSH or HTTPS URL → owner/repo
    REPO=$(echo "$REMOTE" \
        | sed -E 's|git@github\.com:||; s|https://github\.com/||; s|\.git$||')
fi


[[ "$REPO" == */* ]] || die "Could not parse a valid OWNER/REPO from: $REPO"


ENV_NAME="${2-production}"


# ── confirm gh is available and authed ───────────────────────────────────────


command -v gh &>/dev/null || die "'gh' CLI not found. Install it: https://cli.github.com"
gh auth status &>/dev/null  || die "Not logged in to GitHub. Run: gh auth login"


# ── ensure environment exists (if requested) ─────────────────────────────────


if [[ -n "$ENV_NAME" ]]; then
    gh api -X PUT "/repos/$REPO/environments/$ENV_NAME" >/dev/null \
        || die "Failed to create or access environment '$ENV_NAME' on $REPO."
    SCOPE_DESC="environment '$ENV_NAME'"
else
    SCOPE_DESC="repository secrets"
fi


cat <<END


Setting up Apple notarization secrets for: $REPO
Scope: $SCOPE_DESC


END

```

--------------------------------

### Go SDK Usage Example

Source: https://www.stainless.com/docs/guides/configure

Shows how to use the generated Go SDK for a todo list API, demonstrating resource, method, and model mapping, including Go-specific naming conventions.

```go
client := todoninja.NewClient()


var task* todoninja.Task // from `task` model
var err error
//  from `tasks` resource
//                   |
//                   V
task, err = client.Tasks.New(context.TODO(), todoninja.TaskNewParams{
//                       ^
//                       └ from `create` method (more on method names below)
  Deadline: todoninja.Time(time.Now()),
  Name: "Grocery shopping",
})


// from `tags` subresource of `tasks`
//            |            
//            V
client.Tasks.Tags.List(context.TODO(), task_id)
```

--------------------------------

### Install CLI with Go

Source: https://www.stainless.com/docs/cli

For users who have Go installed, this command installs the CLI directly.

```bash
go install github.com/your-org/your-tool/cmd/your-tool@latest
```

--------------------------------

### List Builds Example

Source: https://www.stainless.com/docs/api/python/resources/builds/methods/list

This example demonstrates how to retrieve a list of builds for a project. It shows the structure of the response, including build statuses and pagination details.

```json
{
  "items": [
    {
      "id": "6052018273171456",
      "project_id": "5722911711111111",
      "commit": {
        "sha": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4",
        "author_name": "Test User",
        "author_email": "test@example.com",
        "committer_name": "Test User",
        "committer_email": "test@example.com",
        "message": "Initial commit",
        "timestamp": "2019-12-27T18:11:19.117Z",
        "added": [],
        "removed": [],
        "modified": [
          "README.md"
        ]
      },
      "build_targets": {
        "linux": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "typescript": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        }
      },
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}
```

--------------------------------

### Install PL/Python for PostgreSQL

Source: https://www.stainless.com/docs/sdks/sql

Install the PL/Python package for your PostgreSQL distribution if the 'plpython3u' extension is not available. After installation, create the extension in your database.

```sql
CREATE EXTENSION plpython3u;

```

--------------------------------

### List Project Branches in Kotlin

Source: https://www.stainless.com/docs/api/kotlin/resources/projects/subresources/branches/methods/list

Demonstrates how to initialize the client and list project branches. Ensure the client is configured with the correct project.

```kotlin
package com.configure_me_stainless_v0.api.example

import com.configure_me_stainless_v0.api.client.StainlessClient
import com.configure_me_stainless_v0.api.client.okhttp.StainlessOkHttpClient
import com.configure_me_stainless_v0.api.models.projects.branches.BranchListPage
import com.configure_me_stainless_v0.api.models.projects.branches.BranchListParams

fun main() {
    val client: StainlessClient = StainlessOkHttpClient.builder()
        .fromEnv()
        .project("example-project")
        .build()

    val page: BranchListPage = client.projects().branches().list()
}
```

--------------------------------

### Install CLI from Homebrew Tap

Source: https://www.stainless.com/docs/cli

Commands to tap a new repository and install the CLI, or install directly if the tap is already added.

```bash
brew tap your-org/tools
brew install your-tool
# or more concise:
brew install your-org/tools/your-tool
```

--------------------------------

### Install Early Access SDK

Source: https://www.stainless.com/docs/sdks/test/branches

Share this install command with your early access users to allow them to install the specific early access branch of the SDK.

```bash
npm install 'https://pkg.stainless.com/s/your-early-access-branch/123...'
```

--------------------------------

### List Project Branches in Ruby

Source: https://www.stainless.com/docs/api/ruby/resources/projects/subresources/branches/methods/list

Demonstrates how to initialize the client and list project branches. Ensure you have your API key and environment configured.

```ruby
require "stainless_v0"

stainless = StainlessV0::Client.new(
  api_key: "My API Key",
  environment: "staging" # defaults to "production"
)

page = stainless.projects.branches.list(project: "project")

puts(page)
```

--------------------------------

### Install Project Dependencies with pnpm

Source: https://www.stainless.com/docs/docs-platform/quickstart

Run this command inside your site's directory to install the necessary dependencies for your documentation site. Ensure you have pnpm installed.

```bash
pnpm install
```

--------------------------------

### Create Build

Source: https://www.stainless.com/docs/api/php/resources/builds/methods/create

This example demonstrates how to create a new build using the Client SDK. It includes parameters for project, revision, and optional settings like branch, commit messages, and target platforms.

```APIDOC
## Create Build

### Description
Creates a new build for a specified project and revision. Allows for customization of commit messages and target platforms.

### Method
```php
$client->builds->create()
```

### Parameters

#### Required Parameters
- **project** (string) - The name of the project for which to create the build.
- **revision** (string) - The revision identifier for the build.

#### Optional Parameters
- **allowEmpty** (bool) - Whether to allow an empty build.
- **branch** (string) - The branch name for the build.
- **commitMessage** (string) - A custom commit message for the build.
- **enableAICommitMessage** (bool) - Whether to enable AI-generated commit messages.
- **targetCommitMessages** (array) - An associative array mapping target names to their commit messages.
- **targets** (array) - An array of target platforms for the build (e.g., `[Target::NODE]`).

### Request Example
```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'My API Key', environment: 'staging');

$build = $client->builds->create(
  project: 'project',
  revision: 'string',
  allowEmpty: true,
  branch: 'branch',
  commitMessage: 'commit_message',
  enableAICommitMessage: true,
  targetCommitMessages: [
    'cli' => 'cli',
    'csharp' => 'csharp',
    'go' => 'go',
    'java' => 'java',
    'kotlin' => 'kotlin',
    'node' => 'node',
    'openAPI' => 'openapi',
    'php' => 'php',
    'python' => 'python',
    'ruby' => 'ruby',
    'sql' => 'sql',
    'terraform' => 'terraform',
    'typescript' => 'typescript',
  ],
  targets: [Target::NODE],
);

var_dump($build);
```

### Response

#### Success Response (200)
Returns a build object upon successful creation.

#### Response Example
```json
{
  "id": "id",
  "config_commit": "config_commit",
  "created_at": "2019-12-27T18:11:19.117Z",
  "documented_spec": {
    "content": "content",
    "type": "content"
  },
  "object": "build",
  "org": "org",
  "project": "project",
  "targets": {
    "cli": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "csharp": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "go": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "java": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "kotlin": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "node": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "openapi": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "php": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "python": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "ruby": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "sql": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "terraform": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    }
  }
}
```
```

--------------------------------

### 200 OK Example

Source: https://www.stainless.com/docs/api/csharp/resources/builds/methods/list

This example shows the structure of a successful response when listing builds. It includes details about build targets and their statuses.

```json
{
  "data": [
    {
      "id": "id",
      "config_commit": "config_commit",
      "created_at": "2019-12-27T18:11:19.117Z",
      "documented_spec": {
        "content": "content",
        "type": "content"
      },
      "object": "build",
      "org": "org",
      "project": "project",
      "targets": {
        "cli": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "csharp": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "go": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "java": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "kotlin": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "node": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "openapi": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "php": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "python": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "ruby": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "sql": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "terraform": {
          "commit": {

```

--------------------------------

### Install Stainless PHP Library via Composer

Source: https://www.stainless.com/docs/api/php

Add this configuration to your composer.json file to install the Stainless PHP library. Ensure you have Composer installed and configured for your project.

```json
{
  "repositories": [
    {
      "type": "vcs",
      "url": "git@github.com:stainless-sdks/stainless-v0-php.git"
    }
  ],
  "require": {
    "org-placeholder/stainless-v0": "dev-main"
  }
}
```

--------------------------------

### Create Build Example

Source: https://www.stainless.com/docs/api/python/resources/builds/methods/create

This example demonstrates a successful response when creating a build. It includes details about the build's status, configuration, and targets.

```APIDOC
## POST /builds

### Description
Creates a new build for the specified project.

### Method
POST

### Endpoint
/builds

### Request Body
- **config_commit** (string) - Required - The commit hash for the configuration.
- **documented_spec** (object) - Required - The documented specification for the build.
  - **content** (string) - Required - The content of the specification.
  - **type** (string) - Required - The type of the specification.

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the build.
- **config_commit** (string) - The commit hash used for the configuration.
- **created_at** (string) - The timestamp when the build was created.
- **documented_spec** (object) - The documented specification.
  - **content** (string) - The content of the specification.
  - **type** (string) - The type of the specification.
- **object** (string) - The type of object, which is 'build'.
- **org** (string) - The organization the build belongs to.
- **project** (string) - The project the build belongs to.
- **targets** (object) - An object containing build targets.
  - **cli** (object) - Details for the CLI build target.
    - **commit** (object) - Commit status for the CLI target.
      - **status** (string) - The commit status.
    - **install_url** (string) - The installation URL for the CLI target.
    - **object** (string) - The type of object, which is 'build_target'.
    - **status** (string) - The overall status of the CLI target.
    - **build** (object) - Build status for the CLI target.
      - **status** (string) - The build status.
    - **lint** (object) - Lint status for the CLI target.
      - **status** (string) - The lint status.
    - **test** (object) - Test status for the CLI target.
      - **status** (string) - The test status.
  - **csharp** (object) - Details for the C# build target (similar structure to 'cli').
  - **go** (object) - Details for the Go build target (similar structure to 'cli').
  - **java** (object) - Details for the Java build target (similar structure to 'cli').
  - **kotlin** (object) - Details for the Kotlin build target (similar structure to 'cli').
  - **node** (object) - Details for the Node.js build target (similar structure to 'cli').
  - **openapi** (object) - Details for the OpenAPI build target (similar structure to 'cli').
  - **php** (object) - Details for the PHP build target (similar structure to 'cli').
  - **python** (object) - Details for the Python build target (similar structure to 'cli').
  - **ruby** (object) - Details for the Ruby build target (similar structure to 'cli').
  - **sql** (object) - Details for the SQL build target (similar structure to 'cli').
  - **terraform** (object) - Details for the Terraform build target (similar structure to 'cli').
  - **typescript** (object) - Details for the TypeScript build target (similar structure to 'cli').
- **updated_at** (string) - The timestamp when the build was last updated.

### Response Example
```json
{
  "id": "id",
  "config_commit": "config_commit",
  "created_at": "2019-12-27T18:11:19.117Z",
  "documented_spec": {
    "content": "content",
    "type": "content"
  },
  "object": "build",
  "org": "org",
  "project": "project",
  "targets": {
    "cli": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "csharp": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "go": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "java": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "kotlin": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "node": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "openapi": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "php": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "python": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "ruby": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "sql": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "terraform": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    },
    "typescript": {
      "commit": {
        "status": "not_started"
      },
      "install_url": "install_url",
      "object": "build_target",
      "status": "not_started",
      "build": {
        "status": "not_started"
      },
      "lint": {
        "status": "not_started"
      },
      "test": {
        "status": "not_started"
      }
    }
  },
  "updated_at": "2019-12-27T18:11:19.117Z"
}
```
```

--------------------------------

### Initialize Client with Read and Write Keys (Go)

Source: https://www.stainless.com/docs/sdks/configure/client

Initialize the client with both read and write API keys. Both keys will be sent with every request.

```go
client := myapi.NewClient(
    option.WithReadKey("read_key_123"),
    option.WithWriteKey("write_key_456"),
)


// Both keys are sent with requests
client.Resources.List(ctx)
client.Resources.New(ctx, ...)
```

--------------------------------

### Fern Frontmatter Example

Source: https://www.stainless.com/docs/migrate/fern-docs

Example of frontmatter used in Fern documentation files.

```yaml
---
title: How to integrate
description: Learn how to integrate your API documentation
subtitle: Customize content using frontmatter
slug: how-to-integrate
keywords: integration, sdk generation, api, mcp servers, documentation
og:site_name: Your Company Inc.
og:title: SEO Metadata Title
---
```