Merge pull request #6 from moderation-api/speakeasy/regenerate

feat!: v0.3.0, breaking API changes

Author: chrisdengso

.speakeasy/gen.lock

@@ -33,7 +33,7 @@ generation:
     generateNewTests: true
     skipResponseBodyAssertions: false
 cli:
-  version: 0.2.1
+  version: 0.3.0
   additionalDependencies: {}
   agentEnvironmentDetection: true
   arrayFlagFormat: repeatable

.speakeasy/gen.yaml

@@ -1,5 +1,53 @@
 # Changelog
 
+## 0.3.0 (2026-10-22)
+
+Full Changelog: [v0.2.1...v0.3.0](https://github.com/moderation-api/cli/compare/v0.2.1...v0.3.0)
+
+### ⚠ Breaking changes
+
+- `GET /actions`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /actions`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /actions/execute`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /actions/{actionId}/execute`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `DELETE /actions/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `GET /actions/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `PUT /actions/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `GET /auth`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /auth`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `GET /authors`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /authors`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `DELETE /authors/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `GET /authors/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `PUT /authors/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `DELETE /channels/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `PUT /channels/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /channels/{id}/duplicate`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /moderate`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /moderate/image`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /moderate/text`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /projects`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `PUT /projects/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /projects/{id}/duplicate`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /projects/{projectId}/channels`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `GET /queue/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `GET /queue/{id}/items`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /queue/{id}/items/{itemId}/resolve`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /queue/{id}/items/{itemId}/unresolve`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `GET /queue/{id}/stats`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /webhooks`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `PUT /webhooks/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `GET /wordlist`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `GET /wordlist/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `PUT /wordlist/{id}`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `GET /wordlist/{id}/embedding-status`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `DELETE /wordlist/{id}/words`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+- `POST /wordlist/{id}/words`: added the new `project_name_ambiguous` enum value to the `code` response property for the response status `400`
+
+### API changes
+
+- a breaking change was detected but the version is still `1.1.0`
+
 ## 0.2.1 (2026-10-22)
 
 Full Changelog: [v0.2.0...v0.2.1](https://github.com/moderation-api/cli/compare/v0.2.0...v0.2.1)

.speakeasy/openapi.json

@@ -339,9 +339,9 @@ Configuration is stored in `~/.config/modapi/config.yaml`.
 Moderation API has two kinds of API keys:
 
 - A **project key** works with one project: content, authors, review queues, actions, wordlists, webhooks and the account.
-- An **organization key** works with the [management API](https://docs.moderationapi.com/api-reference/management-api): `modapi projects` and `modapi channels`. The management API is available on Enterprise plans.
+- An **organization key** works with the [management API](https://docs.moderationapi.com/api-reference/management-api): `modapi projects` and `modapi channels`. It can also use any project's endpoints: name the project with `--project-id`.
 
-Each key works only with its own commands. With the wrong key the API returns `403` with the code `project_key_required` or `organization_key_required`. To run a management command while `MODAPI_SECRET_KEY` holds your project key, pass the organization key for that command:
+A project key can't run the management commands: the API returns `403` with the code `organization_key_required`. To run a management command while `MODAPI_SECRET_KEY` holds your project key, pass the organization key for that command:
 
 ```bash
 modapi projects list --secret-key "$MODAPI_ORGANIZATION_KEY"

CHANGELOG.md

@@ -14,7 +14,7 @@ import (
 )
 
 var retrieveCmdMeta = []flagutil.FlagMeta{
-	{FlagName: "project-id", Shorthand: "p", FieldPath: "ProjectID", Kind: flagutil.FlagKindString, Optional: true, Description: "The project to act on, when you call with an organization key. Optional when the organization has one project. A project key acts on its own project: naming another one is an error."},
+	{FlagName: "project-id", Shorthand: "p", FieldPath: "ProjectID", Kind: flagutil.FlagKindString, Optional: true, Description: "The project to act on, by ID or name. Required with an organization key unless the key reaches only one project; list projects with GET /projects. A project key acts on its own project and needs no value: naming another one is an error."},
 }
 
 // initRetrieveCmd initializes the retrieve command.

README.md

@@ -14,7 +14,7 @@ import (
 )
 
 var createCmdMeta = []flagutil.FlagMeta{
-	{FlagName: "project-id", FieldPath: "ProjectID", Kind: flagutil.FlagKindString, Optional: true, Description: "The project to act on, when you call with an organization key. Optional when the organization has one project. A project key acts on its own project: naming another one is an error."},
+	{FlagName: "project-id", FieldPath: "ProjectID", Kind: flagutil.FlagKindString, Optional: true, Description: "The project to act on, by ID or name. Required with an organization key unless the key reaches only one project; list projects with GET /projects. A project key acts on its own project and needs no value: naming another one is an error."},
 	{FlagName: "key", Shorthand: "k", FieldPath: "Body.Key", Kind: flagutil.FlagKindJSON, Optional: true, Annotations: `json:"key,omitempty"`, Description: "User defined key of the action."},
 	{FlagName: "name", Shorthand: "n", FieldPath: "Body.Name", Kind: flagutil.FlagKindString, Required: true, Description: "The name of the action. [required]"},
 	{FlagName: "description", FieldPath: "Body.Description", Kind: flagutil.FlagKindJSON, Optional: true, Annotations: `json:"description,omitempty"`, Description: "The description of the action."},

internal/cli/account/retrieve.go

@@ -16,7 +16,7 @@ import (
 
 var deleteCmdMeta = []flagutil.FlagMeta{
 	{FlagName: "id", Shorthand: "i", FieldPath: "ID", Kind: flagutil.FlagKindString, Required: true, Description: "The ID of the action to delete. [required]"},
-	{FlagName: "project-id", Shorthand: "p", FieldPath: "ProjectID", Kind: flagutil.FlagKindString, Optional: true, Description: "The project to act on, when you call with an organization key. Optional when the organization has one project. A project key acts on its own project: naming another one is an error."},
+	{FlagName: "project-id", Shorthand: "p", FieldPath: "ProjectID", Kind: flagutil.FlagKindString, Optional: true, Description: "The project to act on, by ID or name. Required with an organization key unless the key reaches only one project; list projects with GET /projects. A project key acts on its own project and needs no value: naming another one is an error."},
 }
 
 // initDeleteCmd initializes the delete command.

internal/cli/actions/create.go

@@ -14,7 +14,7 @@ import (
 )
 
 var executeCmdMeta = []flagutil.FlagMeta{
-	{FlagName: "project-id", Shorthand: "p", FieldPath: "ProjectID", Kind: flagutil.FlagKindString, Optional: true, Description: "The project to act on, when you call with an organization key. Optional when the organization has one project. A project key acts on its own project: naming another one is an error."},
+	{FlagName: "project-id", Shorthand: "p", FieldPath: "ProjectID", Kind: flagutil.FlagKindString, Optional: true, Description: "The project to act on, by ID or name. Required with an organization key unless the key reaches only one project; list projects with GET /projects. A project key acts on its own project and needs no value: naming another one is an error."},
 	{FlagName: "action-key", FieldPath: "Body.ActionKey", Kind: flagutil.FlagKindString, Required: true, Description: "ID or key of the action to execute [required]"},
 	{FlagName: "content-ids", Shorthand: "c", FieldPath: "Body.ContentIds", Kind: flagutil.FlagKindStringArray, Optional: true, Description: "IDs of the content items to apply the action to. Provide this or authorIds."},
 	{FlagName: "author-ids", FieldPath: "Body.AuthorIds", Kind: flagutil.FlagKindStringArray, Optional: true, Description: "IDs of the authors to apply the action to. Provide this or contentIds."},

internal/cli/actions/delete.go

@@ -17,7 +17,7 @@ var listCmdMeta = []flagutil.FlagMeta{
 	{FlagName: "queue-id", FieldPath: "QueueID", Kind: flagutil.FlagKindString, Optional: true, Description: "string value"},
 	{FlagName: "page", FieldPath: "Page", Kind: flagutil.FlagKindInt64, Optional: true, HasDefault: true, DefaultInt: 1, HasMinimum: true, Minimum: 1, HasMaximum: true, Maximum: 100000, Description: "integer value"},
 	{FlagName: "page-size", FieldPath: "PageSize", Kind: flagutil.FlagKindInt64, Optional: true, HasDefault: true, DefaultInt: 20, HasMinimum: true, Minimum: 1, HasMaximum: true, Maximum: 100, Description: "integer value"},
-	{FlagName: "project-id", FieldPath: "ProjectID", Kind: flagutil.FlagKindString, Optional: true, Description: "The project to act on, when you call with an organization key. Optional when the organization has one project. A project key acts on its own project: naming another one is an error."},
+	{FlagName: "project-id", FieldPath: "ProjectID", Kind: flagutil.FlagKindString, Optional: true, Description: "The project to act on, by ID or name. Required with an organization key unless the key reaches only one project; list projects with GET /projects. A project key acts on its own project and needs no value: naming another one is an error."},
 }
 
 // initListCmd initializes the list command.