PrivateEndpoints - OpenRouter

Overview

Private Endpoints endpoints

Available Operations

List - List private endpoints
Create - Create a private endpoint
Delete - Delete a private endpoint
Get - Get a private endpoint
Update - Update a draft private endpoint
Activate - Activate a validated private endpoint
Disable - Disable a private endpoint
Enable - Enable a private endpoint
UpdatePricing - Set private endpoint pricing
Validate - Validate a draft private endpoint

List

List the organization’s private endpoints, including drafts. Requires the private endpoints entitlement. Management key required.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.PrivateEndpoints.List(ctx)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.ListPrivateEndpointsResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.RequestTimeoutResponseError	408	application/json
sdkerrors.InternalServerResponseError	500	application/json
sdkerrors.APIError	4XX, 5XX	/

Create

Create a private endpoint as a draft. Drafts are not routable: validate one with POST /private-endpoints/{id}/validate, then activate it with POST /private-endpoints/{id}/activate. Pass activate to do all three in one call; if validation fails the draft is kept and returned with the failed checks. Send an Idempotency-Key header to make retries safe: a repeated key with the same request returns the endpoint the first request created; reusing it with different fields returns 422 idempotency_key_reused. Management key required.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"github.com/OpenRouterTeam/go-sdk/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.PrivateEndpoints.Create(ctx, components.CreatePrivateEndpointRequest{
        ModelPermaslug: "openai/gpt-4o-2024-08-06",
        ProviderSlug: "azure",
        UpstreamModelID: "gpt-4o-prod",
    }, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`createPrivateEndpointRequest`	components.CreatePrivateEndpointRequest	:heavy_check_mark:	N/A
`idempotencyKey`	`*string`	:heavy_minus_sign:	Retry-safe create: a repeated create with the same key from the same organization returns the endpoint the first request created instead of creating another. The endpoint is returned as it is now. Reusing a key with a different request body (model, provider, base URL, upstream model ID, declared ZDR or region, or pricing) is rejected with 422 `idempotency_key_reused`. `activate` is not compared, and later edits to the endpoint do not affect the comparison.	wayfair-gpt-4o-eastus-2026-09
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.ManagedPrivateEndpointResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.BadRequestResponseError	400	application/json
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.NotFound	404	application/json
sdkerrors.RequestTimeoutResponseError	408	application/json
sdkerrors.Conflict	409	application/json
sdkerrors.UnprocessableEntity	422	application/json
sdkerrors.InternalServerError	500	application/json
sdkerrors.BadGateway	502	application/json
sdkerrors.APIError	4XX, 5XX	/

Delete

Delete a private endpoint and stop routing to it. Pass draft_only=true to refuse (409) when the endpoint has been activated. Management key required.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.PrivateEndpoints.Delete(ctx, "5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11", nil)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`id`	`string`	:heavy_check_mark:	Stable identifier of the private endpoint.	5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11
`draftOnly`	*operations.DraftOnly	:heavy_minus_sign:	When `true`, only delete the endpoint if it is still a draft (409 otherwise).
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.DeletePrivateEndpointResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.BadRequestResponseError	400	application/json
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.NotFoundResponseError	404	application/json
sdkerrors.RequestTimeoutResponseError	408	application/json
sdkerrors.ConflictResponseError	409	application/json
sdkerrors.UnprocessableEntityResponseError	422	application/json
sdkerrors.InternalServerResponseError	500	application/json
sdkerrors.BadGatewayResponseError	502	application/json
sdkerrors.APIError	4XX, 5XX	/

Get

Get one private endpoint with its upstream configuration and current pricing. Management key required.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.PrivateEndpoints.Get(ctx, "5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11")
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`id`	`string`	:heavy_check_mark:	Stable identifier of the private endpoint.	5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.PrivateEndpointResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.NotFoundResponseError	404	application/json
sdkerrors.RequestTimeoutResponseError	408	application/json
sdkerrors.InternalServerResponseError	500	application/json
sdkerrors.APIError	4XX, 5XX	/

Update

Replace a draft endpoint’s upstream configuration: send upstream_model_id, and base_url to change it (an omitted base_url keeps the stored one). Omitted data-policy declarations are kept while the upstream is unchanged and cleared when it changes. Any change clears earlier validation. Active endpoints return 409; delete and re-create them instead. Management key required.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"github.com/OpenRouterTeam/go-sdk/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.PrivateEndpoints.Update(ctx, "5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11", components.UpdatePrivateEndpointRequest{
        UpstreamModelID: "gpt-4o-prod",
    })
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`id`	`string`	:heavy_check_mark:	Stable identifier of the private endpoint.	5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11
`updatePrivateEndpointRequest`	components.UpdatePrivateEndpointRequest	:heavy_check_mark:	N/A
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.PrivateEndpointResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.BadRequestResponseError	400	application/json
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.NotFoundResponseError	404	application/json
sdkerrors.RequestTimeoutResponseError	408	application/json
sdkerrors.ConflictResponseError	409	application/json
sdkerrors.UnprocessableEntityResponseError	422	application/json
sdkerrors.InternalServerResponseError	500	application/json
sdkerrors.BadGatewayResponseError	502	application/json
sdkerrors.APIError	4XX, 5XX	/

Activate

Make a validated draft routable. Returns 409 when the endpoint was never validated, the validation is stale, or it is already active. Management key required.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.PrivateEndpoints.Activate(ctx, "5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11")
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`id`	`string`	:heavy_check_mark:	Stable identifier of the private endpoint.	5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.ManagedPrivateEndpointResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.BadRequestResponseError	400	application/json
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.NotFoundResponseError	404	application/json
sdkerrors.RequestTimeoutResponseError	408	application/json
sdkerrors.ConflictResponseError	409	application/json
sdkerrors.UnprocessableEntityResponseError	422	application/json
sdkerrors.InternalServerResponseError	500	application/json
sdkerrors.BadGatewayResponseError	502	application/json
sdkerrors.APIError	4XX, 5XX	/

Disable

Stop routing to an active endpoint without deleting it. Management key required.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.PrivateEndpoints.Disable(ctx, "5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11")
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`id`	`string`	:heavy_check_mark:	Stable identifier of the private endpoint.	5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.ManagedPrivateEndpointResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.BadRequestResponseError	400	application/json
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.NotFoundResponseError	404	application/json
sdkerrors.RequestTimeoutResponseError	408	application/json
sdkerrors.ConflictResponseError	409	application/json
sdkerrors.UnprocessableEntityResponseError	422	application/json
sdkerrors.InternalServerResponseError	500	application/json
sdkerrors.BadGatewayResponseError	502	application/json
sdkerrors.APIError	4XX, 5XX	/

Enable

Resume routing to a disabled endpoint. Management key required.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.PrivateEndpoints.Enable(ctx, "5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11")
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`id`	`string`	:heavy_check_mark:	Stable identifier of the private endpoint.	5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.ManagedPrivateEndpointResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.BadRequestResponseError	400	application/json
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.NotFoundResponseError	404	application/json
sdkerrors.RequestTimeoutResponseError	408	application/json
sdkerrors.ConflictResponseError	409	application/json
sdkerrors.UnprocessableEntityResponseError	422	application/json
sdkerrors.InternalServerResponseError	500	application/json
sdkerrors.BadGatewayResponseError	502	application/json
sdkerrors.APIError	4XX, 5XX	/

UpdatePricing

Set the negotiated per-token rates reported for requests routed to this endpoint. Applies to drafts and active endpoints; new rates take effect for subsequent requests. Management key required.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"github.com/OpenRouterTeam/go-sdk/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.PrivateEndpoints.UpdatePricing(ctx, "5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11", components.UpdatePrivateEndpointPricingRequest{
        Pricing: components.PrivateEndpointPricing{
            Completion: "0.00001",
            Prompt: "0.0000025",
        },
    })
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`id`	`string`	:heavy_check_mark:	Stable identifier of the private endpoint.	5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11
`updatePrivateEndpointPricingRequest`	components.UpdatePrivateEndpointPricingRequest	:heavy_check_mark:	N/A
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.PrivateEndpointResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.BadRequestResponseError	400	application/json
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.NotFoundResponseError	404	application/json
sdkerrors.RequestTimeoutResponseError	408	application/json
sdkerrors.ConflictResponseError	409	application/json
sdkerrors.UnprocessableEntityResponseError	422	application/json
sdkerrors.InternalServerResponseError	500	application/json
sdkerrors.BadGatewayResponseError	502	application/json
sdkerrors.APIError	4XX, 5XX	/

Validate

Send a live test request to the draft endpoint using the given workspace’s BYOK credential for its provider. A passing validation is required before activation. Failed checks return 200 with passed: false. Management key required.

Example Usage

package main

import(
	"context"
	"os"
	openrouter "github.com/OpenRouterTeam/go-sdk"
	"github.com/OpenRouterTeam/go-sdk/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := openrouter.New(
        openrouter.WithSecurity(os.Getenv("OPENROUTER_API_KEY")),
    )

    res, err := s.PrivateEndpoints.Validate(ctx, "5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11", components.ValidatePrivateEndpointRequest{
        WorkspaceID: "550e8400-e29b-41d4-a716-446655440000",
    })
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
`ctx`	context.Context	:heavy_check_mark:	The context to use for the request.
`id`	`string`	:heavy_check_mark:	Stable identifier of the private endpoint.	5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11
`validatePrivateEndpointRequest`	components.ValidatePrivateEndpointRequest	:heavy_check_mark:	N/A
`opts`	[]operations.Option	:heavy_minus_sign:	The options for this request.

Response

*components.PrivateEndpointValidationResponse, error

Errors

Error Type	Status Code	Content Type
sdkerrors.BadRequestResponseError	400	application/json
sdkerrors.UnauthorizedResponseError	401	application/json
sdkerrors.ForbiddenResponseError	403	application/json
sdkerrors.NotFoundResponseError	404	application/json
sdkerrors.RequestTimeoutResponseError	408	application/json
sdkerrors.ConflictResponseError	409	application/json
sdkerrors.UnprocessableEntityResponseError	422	application/json
sdkerrors.InternalServerResponseError	500	application/json
sdkerrors.BadGatewayResponseError	502	application/json
sdkerrors.APIError	4XX, 5XX	/

​Overview

​Available Operations

​List

​Example Usage

​Parameters

​Response

​Errors

​Create

​Example Usage

​Parameters

​Response

​Errors

​Delete

​Example Usage

​Parameters

​Response

​Errors

​Get

​Example Usage

​Parameters

​Response

​Errors

​Update

​Example Usage

​Parameters

​Response

​Errors

​Activate

​Example Usage

​Parameters

​Response

​Errors

​Disable

​Example Usage

​Parameters

​Response

​Errors

​Enable

​Example Usage

​Parameters

​Response

​Errors

​UpdatePricing

​Example Usage

​Parameters

​Response

​Errors

​Validate

​Example Usage

​Parameters

​Response

​Errors

Overview

Available Operations

List

Example Usage

Parameters

Response

Errors

Create

Example Usage

Parameters

Response

Errors

Delete

Example Usage

Parameters

Response

Errors

Get

Example Usage

Parameters

Response

Errors

Update

Example Usage

Parameters

Response

Errors

Activate

Example Usage

Parameters

Response

Errors

Disable

Example Usage

Parameters

Response

Errors

Enable

Example Usage

Parameters

Response

Errors

UpdatePricing

Example Usage

Parameters

Response

Errors

Validate

Example Usage

Parameters

Response

Errors