openrouter 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

openrouter/operations/bulkunassignmembersfromguardrail.py

@@ -0,0 +1,49 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from openrouter.types import BaseModel
+from openrouter.utils import FieldMetadata, PathParamMetadata, RequestMetadata
+from typing import List
+from typing_extensions import Annotated, TypedDict
+
+
+class BulkUnassignMembersFromGuardrailRequestBodyTypedDict(TypedDict):
+    member_user_ids: List[str]
+    r"""Array of member user IDs to unassign from the guardrail"""
+
+
+class BulkUnassignMembersFromGuardrailRequestBody(BaseModel):
+    member_user_ids: List[str]
+    r"""Array of member user IDs to unassign from the guardrail"""
+
+
+class BulkUnassignMembersFromGuardrailRequestTypedDict(TypedDict):
+    id: str
+    r"""The unique identifier of the guardrail"""
+    request_body: BulkUnassignMembersFromGuardrailRequestBodyTypedDict
+
+
+class BulkUnassignMembersFromGuardrailRequest(BaseModel):
+    id: Annotated[
+        str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
+    ]
+    r"""The unique identifier of the guardrail"""
+
+    request_body: Annotated[
+        BulkUnassignMembersFromGuardrailRequestBody,
+        FieldMetadata(request=RequestMetadata(media_type="application/json")),
+    ]
+
+
+class BulkUnassignMembersFromGuardrailResponseTypedDict(TypedDict):
+    r"""Unassignment result"""
+
+    unassigned_count: float
+    r"""Number of members successfully unassigned"""
+
+
+class BulkUnassignMembersFromGuardrailResponse(BaseModel):
+    r"""Unassignment result"""
+
+    unassigned_count: float
+    r"""Number of members successfully unassigned"""

openrouter/operations/createguardrail.py

@@ -0,0 +1,247 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from openrouter.types import (
+    BaseModel,
+    Nullable,
+    OptionalNullable,
+    UNSET,
+    UNSET_SENTINEL,
+    UnrecognizedStr,
+)
+from openrouter.utils import validate_open_enum
+from pydantic import model_serializer
+from pydantic.functional_validators import PlainValidator
+from typing import List, Literal, Union
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+CreateGuardrailResetIntervalRequest = Union[
+    Literal[
+        "daily",
+        "weekly",
+        "monthly",
+    ],
+    UnrecognizedStr,
+]
+r"""Interval at which the limit resets (daily, weekly, monthly)"""
+
+
+class CreateGuardrailRequestTypedDict(TypedDict):
+    name: str
+    r"""Name for the new guardrail"""
+    description: NotRequired[Nullable[str]]
+    r"""Description of the guardrail"""
+    limit_usd: NotRequired[Nullable[float]]
+    r"""Spending limit in USD"""
+    reset_interval: NotRequired[Nullable[CreateGuardrailResetIntervalRequest]]
+    r"""Interval at which the limit resets (daily, weekly, monthly)"""
+    allowed_providers: NotRequired[Nullable[List[str]]]
+    r"""List of allowed provider IDs"""
+    allowed_models: NotRequired[Nullable[List[str]]]
+    r"""Array of model identifiers (slug or canonical_slug accepted)"""
+    enforce_zdr: NotRequired[Nullable[bool]]
+    r"""Whether to enforce zero data retention"""
+
+
+class CreateGuardrailRequest(BaseModel):
+    name: str
+    r"""Name for the new guardrail"""
+
+    description: OptionalNullable[str] = UNSET
+    r"""Description of the guardrail"""
+
+    limit_usd: OptionalNullable[float] = UNSET
+    r"""Spending limit in USD"""
+
+    reset_interval: Annotated[
+        OptionalNullable[CreateGuardrailResetIntervalRequest],
+        PlainValidator(validate_open_enum(False)),
+    ] = UNSET
+    r"""Interval at which the limit resets (daily, weekly, monthly)"""
+
+    allowed_providers: OptionalNullable[List[str]] = UNSET
+    r"""List of allowed provider IDs"""
+
+    allowed_models: OptionalNullable[List[str]] = UNSET
+    r"""Array of model identifiers (slug or canonical_slug accepted)"""
+
+    enforce_zdr: OptionalNullable[bool] = UNSET
+    r"""Whether to enforce zero data retention"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = [
+            "description",
+            "limit_usd",
+            "reset_interval",
+            "allowed_providers",
+            "allowed_models",
+            "enforce_zdr",
+        ]
+        nullable_fields = [
+            "description",
+            "limit_usd",
+            "reset_interval",
+            "allowed_providers",
+            "allowed_models",
+            "enforce_zdr",
+        ]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m
+
+
+CreateGuardrailResetIntervalResponse = Union[
+    Literal[
+        "daily",
+        "weekly",
+        "monthly",
+    ],
+    UnrecognizedStr,
+]
+r"""Interval at which the limit resets (daily, weekly, monthly)"""
+
+
+class CreateGuardrailDataTypedDict(TypedDict):
+    r"""The created guardrail"""
+
+    id: str
+    r"""Unique identifier for the guardrail"""
+    name: str
+    r"""Name of the guardrail"""
+    created_at: str
+    r"""ISO 8601 timestamp of when the guardrail was created"""
+    description: NotRequired[Nullable[str]]
+    r"""Description of the guardrail"""
+    limit_usd: NotRequired[Nullable[float]]
+    r"""Spending limit in USD"""
+    reset_interval: NotRequired[Nullable[CreateGuardrailResetIntervalResponse]]
+    r"""Interval at which the limit resets (daily, weekly, monthly)"""
+    allowed_providers: NotRequired[Nullable[List[str]]]
+    r"""List of allowed provider IDs"""
+    allowed_models: NotRequired[Nullable[List[str]]]
+    r"""Array of model canonical_slugs (immutable identifiers)"""
+    enforce_zdr: NotRequired[Nullable[bool]]
+    r"""Whether to enforce zero data retention"""
+    updated_at: NotRequired[Nullable[str]]
+    r"""ISO 8601 timestamp of when the guardrail was last updated"""
+
+
+class CreateGuardrailData(BaseModel):
+    r"""The created guardrail"""
+
+    id: str
+    r"""Unique identifier for the guardrail"""
+
+    name: str
+    r"""Name of the guardrail"""
+
+    created_at: str
+    r"""ISO 8601 timestamp of when the guardrail was created"""
+
+    description: OptionalNullable[str] = UNSET
+    r"""Description of the guardrail"""
+
+    limit_usd: OptionalNullable[float] = UNSET
+    r"""Spending limit in USD"""
+
+    reset_interval: Annotated[
+        OptionalNullable[CreateGuardrailResetIntervalResponse],
+        PlainValidator(validate_open_enum(False)),
+    ] = UNSET
+    r"""Interval at which the limit resets (daily, weekly, monthly)"""
+
+    allowed_providers: OptionalNullable[List[str]] = UNSET
+    r"""List of allowed provider IDs"""
+
+    allowed_models: OptionalNullable[List[str]] = UNSET
+    r"""Array of model canonical_slugs (immutable identifiers)"""
+
+    enforce_zdr: OptionalNullable[bool] = UNSET
+    r"""Whether to enforce zero data retention"""
+
+    updated_at: OptionalNullable[str] = UNSET
+    r"""ISO 8601 timestamp of when the guardrail was last updated"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = [
+            "description",
+            "limit_usd",
+            "reset_interval",
+            "allowed_providers",
+            "allowed_models",
+            "enforce_zdr",
+            "updated_at",
+        ]
+        nullable_fields = [
+            "description",
+            "limit_usd",
+            "reset_interval",
+            "allowed_providers",
+            "allowed_models",
+            "enforce_zdr",
+            "updated_at",
+        ]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m
+
+
+class CreateGuardrailResponseTypedDict(TypedDict):
+    r"""Guardrail created successfully"""
+
+    data: CreateGuardrailDataTypedDict
+    r"""The created guardrail"""
+
+
+class CreateGuardrailResponse(BaseModel):
+    r"""Guardrail created successfully"""
+
+    data: CreateGuardrailData
+    r"""The created guardrail"""

openrouter/operations/deleteguardrail.py

@@ -0,0 +1,38 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from openrouter.types import BaseModel
+from openrouter.utils import FieldMetadata, PathParamMetadata, validate_const
+import pydantic
+from pydantic.functional_validators import AfterValidator
+from typing import Literal
+from typing_extensions import Annotated, TypedDict
+
+
+class DeleteGuardrailRequestTypedDict(TypedDict):
+    id: str
+    r"""The unique identifier of the guardrail to delete"""
+
+
+class DeleteGuardrailRequest(BaseModel):
+    id: Annotated[
+        str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
+    ]
+    r"""The unique identifier of the guardrail to delete"""
+
+
+class DeleteGuardrailResponseTypedDict(TypedDict):
+    r"""Guardrail deleted successfully"""
+
+    deleted: Literal[True]
+    r"""Confirmation that the guardrail was deleted"""
+
+
+class DeleteGuardrailResponse(BaseModel):
+    r"""Guardrail deleted successfully"""
+
+    DELETED: Annotated[
+        Annotated[Literal[True], AfterValidator(validate_const(True))],
+        pydantic.Field(alias="deleted"),
+    ] = True
+    r"""Confirmation that the guardrail was deleted"""

openrouter/operations/getguardrail.py

@@ -0,0 +1,161 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from openrouter.types import (
+    BaseModel,
+    Nullable,
+    OptionalNullable,
+    UNSET,
+    UNSET_SENTINEL,
+    UnrecognizedStr,
+)
+from openrouter.utils import FieldMetadata, PathParamMetadata, validate_open_enum
+from pydantic import model_serializer
+from pydantic.functional_validators import PlainValidator
+from typing import List, Literal, Union
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class GetGuardrailRequestTypedDict(TypedDict):
+    id: str
+    r"""The unique identifier of the guardrail to retrieve"""
+
+
+class GetGuardrailRequest(BaseModel):
+    id: Annotated[
+        str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
+    ]
+    r"""The unique identifier of the guardrail to retrieve"""
+
+
+GetGuardrailResetInterval = Union[
+    Literal[
+        "daily",
+        "weekly",
+        "monthly",
+    ],
+    UnrecognizedStr,
+]
+r"""Interval at which the limit resets (daily, weekly, monthly)"""
+
+
+class GetGuardrailDataTypedDict(TypedDict):
+    r"""The guardrail"""
+
+    id: str
+    r"""Unique identifier for the guardrail"""
+    name: str
+    r"""Name of the guardrail"""
+    created_at: str
+    r"""ISO 8601 timestamp of when the guardrail was created"""
+    description: NotRequired[Nullable[str]]
+    r"""Description of the guardrail"""
+    limit_usd: NotRequired[Nullable[float]]
+    r"""Spending limit in USD"""
+    reset_interval: NotRequired[Nullable[GetGuardrailResetInterval]]
+    r"""Interval at which the limit resets (daily, weekly, monthly)"""
+    allowed_providers: NotRequired[Nullable[List[str]]]
+    r"""List of allowed provider IDs"""
+    allowed_models: NotRequired[Nullable[List[str]]]
+    r"""Array of model canonical_slugs (immutable identifiers)"""
+    enforce_zdr: NotRequired[Nullable[bool]]
+    r"""Whether to enforce zero data retention"""
+    updated_at: NotRequired[Nullable[str]]
+    r"""ISO 8601 timestamp of when the guardrail was last updated"""
+
+
+class GetGuardrailData(BaseModel):
+    r"""The guardrail"""
+
+    id: str
+    r"""Unique identifier for the guardrail"""
+
+    name: str
+    r"""Name of the guardrail"""
+
+    created_at: str
+    r"""ISO 8601 timestamp of when the guardrail was created"""
+
+    description: OptionalNullable[str] = UNSET
+    r"""Description of the guardrail"""
+
+    limit_usd: OptionalNullable[float] = UNSET
+    r"""Spending limit in USD"""
+
+    reset_interval: Annotated[
+        OptionalNullable[GetGuardrailResetInterval],
+        PlainValidator(validate_open_enum(False)),
+    ] = UNSET
+    r"""Interval at which the limit resets (daily, weekly, monthly)"""
+
+    allowed_providers: OptionalNullable[List[str]] = UNSET
+    r"""List of allowed provider IDs"""
+
+    allowed_models: OptionalNullable[List[str]] = UNSET
+    r"""Array of model canonical_slugs (immutable identifiers)"""
+
+    enforce_zdr: OptionalNullable[bool] = UNSET
+    r"""Whether to enforce zero data retention"""
+
+    updated_at: OptionalNullable[str] = UNSET
+    r"""ISO 8601 timestamp of when the guardrail was last updated"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = [
+            "description",
+            "limit_usd",
+            "reset_interval",
+            "allowed_providers",
+            "allowed_models",
+            "enforce_zdr",
+            "updated_at",
+        ]
+        nullable_fields = [
+            "description",
+            "limit_usd",
+            "reset_interval",
+            "allowed_providers",
+            "allowed_models",
+            "enforce_zdr",
+            "updated_at",
+        ]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m
+
+
+class GetGuardrailResponseTypedDict(TypedDict):
+    r"""Guardrail details"""
+
+    data: GetGuardrailDataTypedDict
+    r"""The guardrail"""
+
+
+class GetGuardrailResponse(BaseModel):
+    r"""Guardrail details"""
+
+    data: GetGuardrailData
+    r"""The guardrail"""

openrouter/operations/getmodels.py

@@ -1,22 +1,45 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from __future__ import annotations
-from openrouter.types import BaseModel
-from openrouter.utils import FieldMetadata, QueryParamMetadata
-from typing import Optional
+from openrouter.types import BaseModel, UnrecognizedStr
+from openrouter.utils import FieldMetadata, QueryParamMetadata, validate_open_enum
+from pydantic.functional_validators import PlainValidator
+from typing import Literal, Optional, Union
 from typing_extensions import Annotated, NotRequired, TypedDict
 
 
+Category = Union[
+    Literal[
+        "programming",
+        "roleplay",
+        "marketing",
+        "marketing/seo",
+        "technology",
+        "science",
+        "translation",
+        "legal",
+        "finance",
+        "health",
+        "trivia",
+        "academia",
+    ],
+    UnrecognizedStr,
+]
+r"""Filter models by use case category"""
+
+
 class GetModelsRequestTypedDict(TypedDict):
-    category: NotRequired[str]
+    category: NotRequired[Category]
+    r"""Filter models by use case category"""
     supported_parameters: NotRequired[str]
 
 
 class GetModelsRequest(BaseModel):
     category: Annotated[
-        Optional[str],
+        Annotated[Optional[Category], PlainValidator(validate_open_enum(False))],
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
+    r"""Filter models by use case category"""
 
     supported_parameters: Annotated[
         Optional[str],

openrouter/operations/listguardrailkeyassignments.py

@@ -0,0 +1,125 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from openrouter.types import BaseModel, Nullable, UNSET_SENTINEL
+from openrouter.utils import FieldMetadata, PathParamMetadata, QueryParamMetadata
+from pydantic import model_serializer
+from typing import List, Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class ListGuardrailKeyAssignmentsRequestTypedDict(TypedDict):
+    id: str
+    r"""The unique identifier of the guardrail"""
+    offset: NotRequired[str]
+    r"""Number of records to skip for pagination"""
+    limit: NotRequired[str]
+    r"""Maximum number of records to return (max 100)"""
+
+
+class ListGuardrailKeyAssignmentsRequest(BaseModel):
+    id: Annotated[
+        str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
+    ]
+    r"""The unique identifier of the guardrail"""
+
+    offset: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Number of records to skip for pagination"""
+
+    limit: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Maximum number of records to return (max 100)"""
+
+
+class ListGuardrailKeyAssignmentsDataTypedDict(TypedDict):
+    id: str
+    r"""Unique identifier for the assignment"""
+    key_hash: str
+    r"""Hash of the assigned API key"""
+    guardrail_id: str
+    r"""ID of the guardrail"""
+    key_name: str
+    r"""Name of the API key"""
+    key_label: str
+    r"""Label of the API key"""
+    assigned_by: Nullable[str]
+    r"""User ID of who made the assignment"""
+    created_at: str
+    r"""ISO 8601 timestamp of when the assignment was created"""
+
+
+class ListGuardrailKeyAssignmentsData(BaseModel):
+    id: str
+    r"""Unique identifier for the assignment"""
+
+    key_hash: str
+    r"""Hash of the assigned API key"""
+
+    guardrail_id: str
+    r"""ID of the guardrail"""
+
+    key_name: str
+    r"""Name of the API key"""
+
+    key_label: str
+    r"""Label of the API key"""
+
+    assigned_by: Nullable[str]
+    r"""User ID of who made the assignment"""
+
+    created_at: str
+    r"""ISO 8601 timestamp of when the assignment was created"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = []
+        nullable_fields = ["assigned_by"]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m
+
+
+class ListGuardrailKeyAssignmentsResponseTypedDict(TypedDict):
+    r"""List of key assignments"""
+
+    data: List[ListGuardrailKeyAssignmentsDataTypedDict]
+    r"""List of key assignments"""
+    total_count: float
+    r"""Total number of key assignments for this guardrail"""
+
+
+class ListGuardrailKeyAssignmentsResponse(BaseModel):
+    r"""List of key assignments"""
+
+    data: List[ListGuardrailKeyAssignmentsData]
+    r"""List of key assignments"""
+
+    total_count: float
+    r"""Total number of key assignments for this guardrail"""