docs: sync Task publish/unpublish docs with apify-docs #2840

apify-docs PR #2840 formalized the PUT /actor-tasks/{actorTaskId} description: publishing
and unpublishing a task (via isPublic) require write permission to the task's Actor, not
(as this client's docs stated, copied from the reference JS client) "both the task and its
Actor." unpublish()'s docblock had gone further and claimed the opposite - that it needed
only task-level permission - which directly contradicts the spec.

- Corrected TaskClient::publish()/unpublish() docblocks and docs/tasks.md to match the
  spec's actual permission wording.
- Added publish()'s concrete preconditions from the spec (Actor public,
  publicConfig.inputSchemaFields/datasetView set, Actor has fewer than 50 published tasks).
- Bumped CLIENT_VERSION 0.5.0 -> 0.5.1 (patch: docs/comments only, no interface change).
  API_SPEC_VERSION is unchanged (v2-2026-08-05T133145Z already matches the live spec's
  info.version and already contains PR #2840's schema/description text).

Author: claude

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.5.1
+
+- Corrected the write-permission wording on `TaskClient::publish()`/`unpublish()`: the OpenAPI spec
+  states that both `isPublic` and `publicConfig` require write permission to the task's Actor, not
+  (as `unpublish()`'s docblock previously claimed) permission to the task alone. `publish()`'s
+  docblock now also states the Actor's fewer-than-50-published-tasks limit.
+- `docs/tasks.md` updated to match.
+
 ## 0.5.0
 
 Breaking: `RequestQueueClient` methods that previously returned a raw `array<string,mixed>` (or, for

docs/tasks.md

@@ -25,8 +25,9 @@ foreach ($client->tasks()->iterate(new ListOptions(), 50) as $t) {
 
 - `get(): ?Task`, `update(mixed $newFields): Task`, `delete(): void`
 - `publish(): Task`, `unpublish(): Task` — publish/unpublish the task's public landing page, by
-  setting `isPublic` through `update()`. Publishing requires the task's Actor to be public and the
-  task to already have its `publicConfig` set up.
+  setting `isPublic` through `update()`. Both require write permission to the task's Actor;
+  publishing additionally requires the Actor to be public, to have fewer than 50 already-published
+  tasks, and the task's `publicConfig.inputSchemaFields`/`publicConfig.datasetView` to be set.
 - `start(mixed $input = null, ?TaskStartOptions $options = null): ActorRun`
 - `call(mixed $input = null, ?TaskStartOptions $options = null, ?int $waitSecs = null): ActorRun`
 - `getInput(): mixed`, `updateInput(mixed $input): mixed`

src/Resource/TaskClient.php

@@ -59,11 +59,12 @@ public function delete(): void
 
     /**
      * Publishes the task on its public landing page, by setting {@code isPublic} through
-     * {@see update()}.
+     * {@see update()}. Requires write permission to the task's Actor.
      *
-     * The task's Actor must be public and the task must have its public display configuration
-     * ({@code publicConfig}) set up first. Requires write permission to both the task and its
-     * Actor. Publishing an already published task does nothing.
+     * To publish, the task's Actor must be public, its {@code publicConfig.inputSchemaFields} and
+     * {@code publicConfig.datasetView} must be set, and the Actor must have fewer than 50
+     * published tasks; if any of these are not met, the request fails and nothing is changed.
+     * Publishing an already published task does nothing.
      */
     public function publish(): Task
     {
@@ -72,12 +73,12 @@ public function publish(): Task
 
     /**
      * Unpublishes the task from its public landing page, by setting {@code isPublic} through
-     * {@see update()}.
+     * {@see update()}. Like {@see publish()}, this requires write permission to the task's Actor:
+     * the API requires Actor write permission for both {@code isPublic} and {@code publicConfig}.
      *
      * The public display configuration ({@code publicConfig}) is preserved, so the task can be
-     * published again without re-entering it. Unlike {@see publish()}, this only requires write
-     * permission to the task itself (not its Actor), since it does not need to validate the
-     * Actor's public/display eligibility. Unpublishing a task that is not published does nothing.
+     * published again without re-entering it. Unpublishing a task that is not published does
+     * nothing.
      */
     public function unpublish(): Task
     {

src/Version.php

@@ -17,7 +17,7 @@ final class Version
      * The semantic version of this client library (see https://semver.org/).
      * Changes to the public interface other than additive ones are considered breaking changes.
      */
-    public const CLIENT_VERSION = '0.5.0';
+    public const CLIENT_VERSION = '0.5.1';
 
     /**
      * The version of the Apify OpenAPI specification this client was generated and verified